模型事件不会自动触发，必须显式注册且位置严格受限；最常见原因是未在模型init()中调用self::event()注册，或事件名大小写/下划线错误，或批量操作（如where()->update()）绕过模型实例导致事件失效。
模型事件不会自动触发，必须显式注册且位置严格受限——漏掉 init() 或写错事件名，整个钩子链就失效。
为什么 before_insert 什么都没输出？
最常见原因是没在模型的 init() 静态方法里调用 self::event() 注册。ThinkPHP 不扫描方法名，也不按命名约定自动绑定。它只认你亲手塞进去的那条注册语句。
-
self::event('before_insert', [UserModel::class, 'onBeforeInsert']);是合法写法；直接写public function before_insert() {}完全无效 - 子类继承父类模型时，
init()不会自动调用父类的parent::init()，必须手动补上 - 如果用了
protected $dispatchesEvents（Laravel 风格），那和self::event()是两套机制，混用会导致监听器不触发
$dispatchesEvents 数组怎么配才生效？
这个属性只在 ThinkPHP 6+ 的 Eloquent 兼容层中起作用，且仅对继承 think\Model 并启用该模式的模型有效。配置必须完全匹配框架内置事件名，大小写、下划线都不能错。
- 键必须是小写带下划线：
'created'、'updated'、'retrieved'—— 写成'Created'或'afterCreate'都不会触发 - 值必须是完整命名空间路径字符串：
app\observer\UserCreatedListener::class，不能是相对路径或类名简写 - 软删除模型监听
'deleted'永远收不到真实删除信号，得用'forceDeleted'
批量操作如 where()->update() 为啥不走模型事件？
因为这类写法绕过了单实例生命周期：没有创建模型对象，没有比对脏数据，没有触发 before_update 或 after_update。框架底层直接执行 PDO update，连模型类都未实例化。
立即学习“PHP免费学习笔记（深入）”；
- 想统一处理字段变更逻辑，只能改用单实例方式：
$user = UserModel::find(1); $user->status = 0; $user->save(); - 或者放弃模型事件，改用数据库触发器（trigger）或在 Service 层封装统一更新入口
-
retrieved事件里改属性不会进脏数据队列，后续save()不会更新它；真要改，得手动调$model->setDirty('field', $value)
before_write 和 after_write 是什么关系？
这是 ThinkPHP 原生模型事件中最容易被误用的一对。它们不是“新增/更新专属”，而是覆盖所有写入动作（包括 insert 和 update）的通用钩子，且 before_write 在校验之后、SQL 生成之前执行，after_write 在 SQL 执行成功后、事务提交前运行。
-
before_write是修改即将入库数据的最后机会，比如根据$this->origin和$this->data判断状态变化并写入disable_time -
after_write适合发通知、清缓存、记录日志，但注意：如果事务回滚，它已执行过的逻辑不会自动撤销 - 不要在
after_write里再调save()，可能引发无限递归或死锁
真正难的不是写事件函数，而是判断该用哪套机制：是原生 self::event()、Laravel 风格 $dispatchesEvents，还是观察者 Event::observe()。三者注册时机、生效范围、参数传递方式完全不同，混在一起调试时连日志都对不上行号。
