ThinkPHP事件测试必须确保监听器真实触发：需注册到容器、用全限定类名触发、mock外部依赖、验证副作用而非返回值，并在每个测试后调用Event::clear()清理。
ThinkPHP 的事件（Event）本身不参与 HTTP 生命周期，但测试时容易误当成“控制器调用”去测，结果断言全绿、逻辑却没跑 —— 因为事件监听器根本没被触发。关键不是“怎么写”，而是“怎么确保它真被 dispatch 了”。
事件类和监听器必须注册到容器才能被测试识别
TP8 默认使用 thinkeventEvent，但它的行为依赖容器绑定。如果只是 new 一个 Event 实例并手动 dispatch，监听器不会执行（因为没走容器解析，bind 和 listen 都没生效）。
- 正确做法：在
setUp()中显式初始化事件系统：Event::clear(); App::init(); - 监听器类需在
app/event.php或通过Event::listen('UserRegistered', [UserLogListener::class, 'handle'])注册，不能只靠注解或配置文件自动加载（测试环境默认不加载应用配置） - 若用注解方式（如
@event），需确认已启用thinknnotationAnnotation并在测试中调用Annotation::scan()
Event::trigger() 必须传入完整事件名，且大小写敏感
常见错误是传错事件标识符，比如写成 UserRegistered 却实际注册的是 user_registered（小写下划线风格），或者漏掉命名空间前缀。
- 触发前先 dump 一下当前注册的监听器：
var_dump(Event::getListeners('app\event\UserRegistered')); - 推荐统一用全限定类名作事件名：
Event::trigger(ppeventUserRegistered::class, $data); - 不要用字符串拼接或变量传入未确认的事件名，否则
trigger()静默失败（无报错、无监听器执行）
监听器里调 DB 或外部服务，得 mock 而不是 refreshDatabase
事件监听器通常是异步或副作用密集型逻辑（发短信、写日志表、调第三方 API），直接跑真实 DB 会拖慢测试、污染数据，且违反单元测试“隔离性”原则。
立即学习“PHP免费学习笔记（深入）”；
- 用
Mocker::mock()替换具体服务类：$logger = Mocker::mock(LoggerInterface::class); App::bind(LoggerInterface::class, $logger); - 避免在监听器里直接 new 模型或 Db 类；改用容器获取：
Db::name('log')->insert(...)→ 改为Container::get('db')->name('log')->insert(...)，才方便 bind 替换 -
refreshDatabase()对事件测试基本无效 —— 它只重置迁移和种子，不拦截trigger()后的任意写操作
测试事件是否触发，不能只看返回值，要看监听器副作用
Event::trigger() 总是返回 true（即使没监听器），所以不能靠 $this->assertTrue(Event::trigger(...)) 来断言成功。
- 正确验证方式：监听器内部修改某个可观察状态（如静态计数器、mock 方法调用次数、临时文件写入）
- 示例：
$listener = Mocker::mock(UserLogListener::class)->makePartial(); $listener->shouldReceive('handle')->once(); Event::listen('UserRegistered', $listener); Event::trigger('UserRegistered', ['id' => 123]); - 注意：TP8 的
Mocker不支持对 final 类或 private 方法打桩，监听器类别加final，方法别设private
最容易被忽略的一点：事件测试必须清理监听器注册表。每个测试末尾加 Event::clear();，否则上一个测试里 listen() 的绑定会残留，导致下一个测试的 trigger() 意外触发不该出现的监听器 —— 这类干扰极难定位，现象是“单独跑通过，一起跑就失败”。
