ThinkPHP6 钩子调试三板斧：我是怎么从"事件发了没反应"到"断点精准命中"的
上周重构一个老项目，把原本散落在十几个控制器里的积分发放逻辑抽出来，打算用行为钩子统一管理。结果事件定义好了、监听也绑了，发出去跟石沉大海一样，日志里干干净净，愣是不知道哪一步断了。
这篇文章不聊基础概念，就说说我在"挂钩子"和"调试事件"这两件事上，从瞎猜到有章法的过程。
=== 一、先搞清楚三种挂载方式，别像我当初一样混着用 ===
ThinkPHP6 里能挂事件的地方我总结就三条路：
1. 配置文件里写死：config/event.php 的 listen 数组，适合系统级、全局必走的监听，比如用户注册后发欢迎邮件。缺点是改个监听要动配置，热更新不方便。
2. Event::listen 动态绑：一般在服务（Service）的 boot 方法里写，适合模块级别。我现在的习惯是，每个业务模块单独建一个 Service 类，boot 里把该模块的事件监听一次性挂好，比全堆在 config 里清爽。
3. 直接在触发点 subscribe：这个我踩过坑。subscribe 是订阅者模式，一个类里可以监听多个事件，但很多人（包括我）容易和 listen 搞混。subscribe 适合"一个人管多件事"，listen 适合"一件事有多个人管"。
我那个积分重构项目，一开始把 subscribe 和 listen 混着用，结果同一个事件被触发了两遍，排查半天才发现 config 里 listen 了一份，Service 里 subscribe 又挂了一份。现在我的铁律：同个事件，只选一种方式挂，写注释标明在哪挂的。
=== 二、事件发了没反应？我的排查顺序 ===
遇到事件不执行，我现在按这个顺序查，基本五分钟内定位：
第一步：确认事件类有没有被加载
在事件类的构造函数里随便写个 Log::info('event constructed')，触发后看日志出没出。没出说明事件类本身就没实例化，问题在"触发端"——要么 Event::trigger 的类名写错了，要么自动加载没扫到（比如事件类放错命名空间）。
第二步：确认监听器的 handle 有没有进
监听器的 handle 方法第一行加日志。如果事件类构造了但 handle 没进，说明监听绑定有问题。常见原因：listen 数组的键名和 trigger 的事件名对不上（比如一个带命名空间一个不带）；或者 subscribe 类里的 subscribe 方法返回的数组格式写错了。
第三步：确认监听器的返回值有没有被吞
这是我最隐蔽的一个坑。某个监听器的 handle 里 return false，结果后面排队的监听器全被截断了，因为 ThinkPHP 的事件机制里，某个监听返回非 null 且非空数组时，可能会中断后续执行（取决于你怎么处理返回值）。后来我在需要"中断"的地方显式写注释，普通监听统一 return null，避免手滑。
=== 三、本地调试的两个野路子 ===
正式环境不能乱打日志，但本地调试事件，我有两个用得顺手的办法：
野路子一：中间件里 dump 事件流
写个全局中间件，在 handle 开头加 Event::listen('*', function ($event) { dump(class_basename($event)); })，这样所有触发的事件名都会打在页面上。适合初期梳理一个页面到底发了多少事件，有没有漏的、有没有多余的。记得提交前删掉，不然上线后就是灾难。
野路子二：利用 app()->isDebug() 做分级日志
我在基类监听器里封装了一层：debug 模式下，事件触发前、监听执行前、监听执行后各打一行 trace 日志，带时间戳。正式环境自动关闭，不影响性能。重构那段时间靠这个，一眼就能看出哪个监听耗时异常。
=== 四、一个现在还在用的目录习惯 ===
之前事件类、监听器类、订阅者类全塞在 app/event 里，文件多了根本找不着。现在我是这样拆的：
- app/Event/ —— 只放事件类（纯数据载体，啥逻辑没有）
- app/Listener/ —— 按业务模块分子目录，比如 User/、Order/、Points/
- app/Subscribe/ —— 只有需要聚合多个事件监听时才用，目前就两个文件
配合 IDE 的书签功能，Event::trigger 的地方打个书签，跳转到对应 Listener 再打一个，重构时来回切很顺畅。
=== 写在最后 ===
钩子这东西，小项目里用不用都行，但业务复杂起来，不抽出来后面就是满天飞的重复代码。我现在的新项目，从第一天就把事件目录搭好，哪怕暂时只有一个监听，也按规范走。前期多花十分钟，后期省掉的可能就是凌晨两小时的排查。
你们平时调试事件有什么顺手的方法？或者遇到过更诡异的"事件发了没反应"的场景？