thinkphp事件监听失效主因是事件系统未启用、模型未正确绑定或cli环境配置差异；需确认app.event为true、observe()调用方式匹配生命周期、观察者方法名全小写且参数唯一、redis过期事件配置正确，并在观察者中加try/catch捕获异常。
ThinkPHP事件监听失效，90%不是代码写错了，而是事件系统根本没开、模型没绑定、或 CLI 环境加载了另一套配置。
event 配置是否真正启用
ThinkPHP 6.1+ 默认开启 app.event，但低版本或自定义配置可能为 false；TP6.3+ 已移除 modelEvent 配置项，只认 app.event。CLI 下常因环境隔离导致该值为 false，而 Web 请求是 true，造成“本地能跑、命令行不触发”的假象。
- 检查
config/app.php中'event' => true（必须是布尔true，不是字符串"true"） - 在命令行执行
php think env或加一行var_dump(config('app.event'))确认实际值 - 别混淆
config/model.php里的旧配置项——TP6.3+ 它已无效
observe() 调用方式是否匹配模型生命周期
observe() 不是全局钩子，它只对**当前模型实例**生效。静态调用 UserModel::observe('UserObserver') 后再用 UserModel::create()，事件不会触发——因为 create() 返回的是新实例，未绑定观察者。
- 正确写法：
(new UserModel())->observe('UserObserver')->create($data) - 若需全局绑定，应在模型的
initialize()方法中调用self::observe('UserObserver')（注意：这仅对后续 new 实例有效） - 确保模型类继承
think\Model，且观察者类存在、可被自动加载（命名空间与路径一致）
观察者类方法签名是否匹配事件名规范
ThinkPHP 不强制实现 ObserverInterface，但要求方法名严格对应小写事件名，如 saving、created、deleted。大小写错、多下划线、加前缀都会导致静默忽略。
- 支持的方法名（全小写）：
saving、saved、creating、created、updating、updated、deleting、deleted - 不要写成
onSaving、Saving或handleSaving - 方法参数必须是单个
$model实例，不能多参或类型声明错误（如public function saving(UserModel $model)在 PHP 8+ 可能因协变失败）
CLI 环境下监听不到 key 失效事件？Redis 配置和客户端设置都得对
Redis 的 key 过期事件不是默认开启的，且 PHP Redis 客户端在订阅时若未设读超时，会卡死在 psubscribe() 调用里，看起来像“没反应”。
- 确认 Redis 配置
notify-keyspace-events "Ex"（不是"AKE"或空），并已redis-cli CONFIG REWRITE或重启服务 - PHP 客户端必须调用
$redis->setOption(\Redis::OPT_READ_TIMEOUT, -1)，否则阻塞等待超时后直接断开 - 订阅频道必须是
__keyevent@0__:expired（数字 0 是数据库编号，按实际 DB 修改） - 命令行进程必须常驻运行，不能一次请求就退出；supervisor 重启后要确认进程 PID 变更，避免旧进程残留
最容易被忽略的一点：观察者方法里抛出异常会中断整个保存流程，但不会报错到日志——除非你开了 app_debug 或手动捕获了 think\exception\EventException。线上环境建议在观察者方法开头加 try/catch 并写入日志，否则失效原因会彻底隐身。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
