ThinkPHP模型事件触发失败主因是监听器未注册、事件名拼错或被事务/中间件拦截；需确认模型继承\think\Model、启用事件机制、正确注册监听器并清除缓存，且事件仅在ORM操作中触发。
确认事件是否被正确注册和启用
模型事件（如 before_insert、after_update）依赖 think\Model 的事件机制，但默认不自动开启。需在模型类中显式调用 Event::listen() 或通过配置启用：
- 确保模型继承的是
\think\Model（非\think\db\Query），且未禁用事件：检查模型中是否有protected $event = [];清空了全部事件 - 若使用自定义事件名（如
user_login_success），必须先用Event::listen('user_login_success', [...])注册监听器，不能只写trigger('user_login_success') - TP6.1+ 支持在模型内用
protected $event = ['before_write' => 'onBeforeWrite']方式绑定方法，但方法必须是 public 且存在，且不能带参数（框架调用时不传参）
检查监听器是否加载并匹配事件名
监听器类需满足命名空间与路径一致，且被容器识别。常见断点：
- 监听器类文件放在
app/listener/下，命名如UserCreatedListener.php，类名为app\listener\UserCreatedListener，不能漏掉app\前缀 - 在
app/provider.php中注册监听器：Event::listen('model_after_insert', \app\listener\UserCreatedListener::class);—— 注意事件名大小写必须完全一致（after_insert≠AfterInsert） - 运行
php think optimize:schema或清空runtime/cache/，避免旧缓存导致监听器未重载
排查事务、异常和静默终止场景
模型事件在事务中执行，一旦事务回滚，after_* 类事件不会触发；而 before_* 虽已触发，但后续操作失败时容易误判为“事件没跑”：
- 在监听器方法开头加
Log::info('UserCreatedListener triggered');，确认是否真没执行，还是执行了但逻辑出错没日志 - 若监听器里抛出未捕获异常（如调用不存在的方法），整个 save() 会失败，但事件可能已部分执行；建议监听器内统一 try/catch 并记录错误
- 某些中间件（如权限校验）在模型操作前就 return 了响应，导致控制器根本没走到 save()，自然没有事件触发
验证事件触发时机与数据状态
模型事件只在 ORM 方法中触发（如 $user->save()、UserModel::create()），不响应原生 SQL 或 Query 构建器操作：
立即学习“PHP免费学习笔记（深入）”；
- 用
Db::table('user')->insert([...])不会触发任何模型事件 —— 这是设计使然，不是 bug -
before_write在数据写入前触发，此时$this->data是待写入字段，但$this->id可能为空；after_insert中才能安全获取自增 ID - 批量操作如
UserModel::insertAll()默认不触发单条事件，需手动循环调用save()或改用事件驱动的队列任务
