Yii2过滤器报错不显示提示，因异常发生在action执行前且非HttpException子类时绕过errorHandler；应抛出yii\web\HttpException子类（如ForbiddenHttpException）并确保Filter正确配置与执行。
Yii2 过滤器（Filter）报错时默认不显示提示，因为错误发生在控制器动作执行前，errorAction 通常还没接管——这是最常被忽略的环节。
过滤器中抛出异常不走 errorHandler？
对。比如在 beforeAction() 或自定义 Filter 的 beforeFilter() 里 throw new \Exception('xxx')，若未显式配置，Yii2 会直接输出空白页或 PHP 错误（取决于 YII_DEBUG 和 PHP 设置），而不会跳转到 site/error。
- 根本原因是：Filter 执行阶段早于 action 路由完成，
ErrorHandler的完整拦截链（如renderException）可能尚未激活 -
YII_DEBUG = true时能看到堆栈，但生产环境会静默失败 - 常见触发点：权限检查失败没 throw 正确 HTTP 异常、
AccessControl规则匹配后 redirect 循环、自定义 Filter 中调用未初始化的服务
必须用 HttpException 子类才能触发友好错误页
Yii2 的 ErrorHandler 只对继承自 yii\web\HttpException 的异常做状态码映射和视图渲染。普通 \Exception 或 \RuntimeException 会被当“致命错误”处理，绕过 errorAction。
- 正确写法：
throw new \yii\web\ForbiddenHttpException('无权访问'); - 404 场景：
throw new \yii\web\NotFoundHttpException('资源不存在'); - 400 场景：
throw new \yii\web\BadRequestHttpException('参数错误'); - 避免：
throw new \Exception('xxx')—— 它不会触发site/error，也不会返回对应 HTTP 状态码
自定义 Filter 中提前捕获并转换异常
如果你的 Filter 逻辑复杂（比如校验 Token、解析请求体），建议主动 catch 并转成 HttpException，而不是让底层错误穿透出去。
public function beforeFilter($event)
{
try {
$this->validateRequest();
} catch (\InvalidArgumentException $e) {
throw new \yii\web\BadRequestHttpException($e->getMessage());
} catch (\DomainException $e) {
throw new \yii\web\ForbiddenHttpException($e->getMessage());
}
return parent::beforeFilter($event);
}
- 不要依赖
Yii::$app->errorHandler->exception()手动触发——它只适用于已进入 action 流程后的异常 - 如果 Filter 报错源于服务未注册（如
Yii::$app->myService不存在），先检查 config 是否漏配components，这类错误必须修复配置，不能靠异常转换掩盖 - 注意：部分 Filter（如
VerbFilter）内部已用 HttpException，无需额外包装；但自定义 Filter 几乎都需要自己包一层
调试时快速确认 Filter 是否生效
最容易被卡住的是 Filter 根本没运行——比如忘了在控制器加 public $enableCsrfValidation = false; 导致 CSRF 验证提前失败，或者 behaviors() 返回空数组。
- 在 Filter 类的
beforeFilter()开头加file_put_contents('/tmp/filter.log', "hit\n", FILE_APPEND);确认是否执行 - 检查控制器是否重写了
behaviors()却没调用parent::behaviors()，导致全局 Filter 被覆盖 - 如果用了模块（如
admin），确保 Filter 配置在模块的behaviors()里，而不是应用级配置——应用级 behaviors 不会自动继承到模块控制器
真正难排查的不是“怎么显示提示”，而是“为什么连提示都看不到”——绝大多数情况是异常类型不对或 Filter 根本没跑起来，这两点比美化错误页面重要得多。
