yii2事件中报错需手动捕获并转为友好提示：用try/catch+setflash或adderror，设$event->isvalid=false阻止保存，避免throw导致500页。
Yii2 事件触发报错时，默认不会自动显示提示，而是抛出异常并交由 errorHandler 处理——这意味着你看到的是错误页（如 500 页面），而不是用户友好的提示框。要让事件中发生的错误“变成提示”，得主动拦截、捕获、转为闪存消息（setFlash）或模型错误（addError），不能依赖框架自动渲染。
事件里抛异常会直接跳转错误页，别直接 throw
在 beforeSave、afterInsert 等事件回调中写 throw new \Exception('xxx')，会导致整个请求中断，进入 site/error 页面。这不是“提示”，是崩溃。
- ✅ 正确做法：用
try/catch捕获业务逻辑异常，再调用Yii::$app->getSession()->setFlash() - ❌ 错误做法：在事件中无保护地执行可能失败的 DB 查询、API 调用、文件操作后直接 throw
- ⚠️ 注意：
Event::trigger()本身不捕获异常；如果监听器里抛出未被捕获的异常，它会向上冒泡到请求入口，触发全局错误处理
在事件监听器中设置 flash 提示（适用于控制器外的错误反馈）
比如你在 User::EVENT_BEFORE_INSERT 里检查邮箱是否已被注册，想给用户弹个提示而不是 500 页：
// 在模型类中定义事件监听
public function init()
{
parent::init();
$this->on(self::EVENT_BEFORE_INSERT, [$this, 'checkEmailUnique']);
}
public function checkEmailUnique($event)
{
if (User::find()->where(['email' => $this->email])->exists()) {
// ❌ 不要 throw new \Exception(...)
// ✅ 改成：把错误存到 session，但注意——模型事件里没有 $this->controller
// 所以得换方式：要么在 controller 触发事件前兜底，要么用 Yii::$app->session
Yii::$app->getSession()->setFlash('error', '该邮箱已存在，请更换');
$event->isValid = false; // 阻止保存
}
}
-
$event->isValid = false是关键，否则验证通过但保存失败，用户得不到任何反馈 - flash 消息必须在响应返回前读取，所以视图里要立刻检查
hasFlash并渲染Alert::widget() - 如果事件发生在 console 应用或非 Web 上下文，
Yii::$app->session不可用，此时只能打日志或抛异常
模型事件 + addError 组合使用（适合表单验证场景）
当事件逻辑和表单字段强相关（例如上传文件后校验格式），优先用 $this->addError()，这样 ActiveForm 能自动定位并显示错误：
public function beforeValidate($attributeNames = null, $clearErrors = true)
{
$result = parent::beforeValidate($attributeNames, $clearErrors);
if ($this->avatar && !$this->validateAvatarFile()) {
$this->addError('avatar', '头像文件必须是 JPG 或 PNG 格式');
}
return $result;
}
-
beforeValidate是安全位置：它在验证流程内，addError生效且不会打断流程 - 不要在
afterValidate里addError，此时验证已结束，错误不会被 ActiveForm 捕获 -
addError的第一个参数必须是真实存在的属性名（如'avatar'），否则错误不会绑定到对应字段
容易忽略的坑：flash 消息只在下一次请求生效
如果你在事件里调用了 setFlash，但紧接着做了 $model->save() 成功并 return $this->redirect()，那 flash 会正常显示；但如果 save 失败、你又没重 render 当前页面，flash 就丢了。
- 重定向（
redirect）后 flash 自动保留一次；但render当前页面时，需确保视图里有hasFlash判断逻辑 - 多个事件监听器都设了
setFlash('error', ...)，后设的会覆盖前设的——要用数组形式批量存：setFlash('error', ['错误1', '错误2']) - 生产环境（
YII_DEBUG = false）下，errorHandler默认不显示堆栈，但事件里的setFlash不受影响，这是可控的提示出口
