模型事件不触发主因是配置或调用时机问题：全局事件系统需开启（尤其CLI下检查app.event）、observe()必须在initialize()中调用、事件方法名须严格小写且拼写正确。
模型事件不触发，90% 是配置或调用时机问题，不是代码写错了。核心就三点：全局事件系统必须开着、observe() 必须在 initialize() 里调、事件方法名必须严格小写且拼写正确。
app.event 是否开启？CLI 环境特别容易翻车
ThinkPHP 6.1+ 默认开启事件系统，但只对 Web 请求生效；CLI 命令（如 php think queue:work）可能加载 app_cli.php 配置，导致 app.event 实际为 false。
- 检查
config/app.php中是否明确设为'event' => true - CLI 下运行
php think config:clear清缓存，再试 - 确认没在
config/model.php里配'event' => true—— TP6.3+ 已移除该配置项，写了也无效
observe() 调用位置错，监听器根本挂不上
observe() 是实例级绑定，不是静态钩子。写在控制器里、构造函数里、或者直接 UserModel::observe()，全都不生效。
- 必须在模型类中定义
public static function initialize() - 在
initialize()里调用self::observe('app\observe\UserObserver') - 若用容器全局注册，改写
app/provider.php：Model::observe(app\observe\UserObserver::class) - 别在控制器里写
UserModel::create()前临时调observe()—— 静态方法不创建实例，监听器压根没机会注册
事件方法名写错，框架直接静默忽略
ThinkPHP 6.1+ 只认标准小写事件名，不兼容旧写法、驼峰、on 前缀或大小写混用。
立即学习“PHP免费学习笔记（深入）”；
- 可用名只有：
created、updated、deleted、restored、beforeWrite、afterWrite、beforeInsert、afterInsert、beforeUpdate、afterUpdate -
afterWrite在 insert 和 update 后都触发，需手动判断$model->isUpdate() - 软删除要监听
forceDeleted才能捕获delete(true)，deleted只响应软删 -
onAfterUpdate、after_update、saved这些全是非法名，写了也不会执行，连日志都不会出
观察者类本身没写对，绑定等于白搭
观察者类不是随便起个名就能被识别的。它要么实现 think\contract\ObserverInterface，要么直接定义对应事件方法（如 created），且方法必须是 public。
- 方法签名必须是
public function created($model)，参数是模型实例，不是数组或请求数据 - 别在观察者构造函数里 throw 异常或做耗时操作 —— 模型初始化失败会导致整个 observe 绑定中断，且无报错提示
- 观察者类路径和命名空间必须与
observe()传入的字符串完全一致，比如app\observe\UserObserver对应app/observe/UserObserver.php
最容易被忽略的是 CLI 环境下配置隔离和 afterWrite 的双场景逻辑 —— 它不区分 insert/update，得自己判断，否则更新时误执行新增逻辑，很难排查。
