Laravel测试中模型事件无法触发的问题排查

问题场景 #

手动测试时模型的创建、更新、删除事件可正常触发，但编写PHPUnit测试时，expectsEvents断言始终失败，调试发现getFiredEvents返回空数组。

测试代码如下：

public function test_booted_method_ran()
{
  $model = AcCard::factory()->create();
  $this->expectsEvents('eloquent.created: \App\Models\AcCard');
}

调试expectsEvents方法后发现$fired为空数组，尝试手动调用flushEventListeners、boot、booted方法也无效。

核心原因 #

expectsEvents方法内部会调用withoutEvents()，这个方法会先禁用所有事件，再记录后续触发的事件。但你是先创建模型再调用expectsEvents，此时模型创建的事件已经触发，不在withoutEvents()的监控范围内，因此断言失败。

修复方案 #

1. 调整代码执行顺序 #

必须先调用expectsEvents声明要监听的事件，再执行触发事件的操作：

public function test_booted_method_ran()
{
  $this->expectsEvents('eloquent.created: \App\Models\AcCard');
  AcCard::factory()->create();
}

2. （推荐）使用事件伪造替代expectsEvents #

Laravel提供的事件伪造功能更灵活，支持精准断言事件触发细节：

public function test_booted_method_ran()
{
  Event::fake();
  
  AcCard::factory()->create();
  
  // 直接断言事件类
  Event::assertDispatched(\Illuminate\Database\Events\Created::class, function ($event) {
      return $event->model instanceof \App\Models\AcCard;
  });
  
  // 或者使用事件名称断言
  Event::assertDispatched('eloquent.created: \App\Models\AcCard');
}

3. 检查模型/工厂是否禁用事件 #

确认模型类或工厂中没有手动禁用事件的代码，比如：

// 检查AcCard模型是否有以下代码，如有需移除
// $this->disableEvents();

// 检查AcCardFactory.php是否有禁用事件的逻辑，如有需移除
// $model->disableEvents();

关键说明 #

• expectsEvents与withoutEvents联动，必须在触发事件的操作之前调用，才能捕获到事件。
• 事件伪造（Event::fake()）是Laravel官方推荐的事件测试方案，支持断言触发次数、事件参数等更多场景。

内容的提问来源于stack exchange，提问作者simpsons3