Laravel如何测试延迟发送的邮件？断言发送失败问题排查

你遇到的问题根源在于：当使用 Queue::fake() 时，队列任务只会被记录为已推送，但不会实际执行。因此，即使任务内部包含发送邮件的逻辑，由于任务没运行，Mail::fake() 无法捕获到邮件发送事件，导致 Mail::assertSent 断言失败。

下面提供两种可行的解决方案：

方案一：手动执行已推送的延迟任务 #

在断言任务已推送后，从假队列中取出任务实例并手动调用其 handle() 方法，触发邮件发送逻辑后再进行断言。

修改后的测试代码示例：

Queue::fake();
Mail::fake();

// 执行触发任务分发的业务代码

// 断言任务已被推送且带有延迟
Queue::assertPushed(ProcessEmailJob::class, function ($job) {
    return !is_null($job->delay);
});

// 取出已推送的任务并手动执行
$job = Queue::pushedJobs()[ProcessEmailJob::class][0];
$job->handle();

// 验证邮件是否发送
Mail::assertSent(EmailUserMail::class);

如果需要精准匹配特定任务（比如根据用户ID筛选），可以优化任务取出逻辑：

$job = collect(Queue::pushedJobs()[ProcessEmailJob::class])->first(function ($job) use ($user) {
    return $job->user->id === $user->id;
});
$job->handle();

方案二：直接测试任务的 handle() 方法 #

跳过队列推送流程，直接实例化任务并调用其核心处理方法，专注验证任务内部的邮件发送逻辑。

示例代码：

Mail::fake();

// 创建任务实例（需传入控制器实例和用户模型，控制器可通过模拟生成）
$controller = $this->createMock(YourController::class);
$job = new ProcessEmailJob($controller, $user);

// 执行任务的核心逻辑
$job->handle();

// 断言邮件已发送，还可验证收件人等细节
Mail::assertSent(EmailUserMail::class, function ($mail) use ($user) {
    return $mail->hasTo($user->email);
});

这种方式更直接，适合单独测试任务的业务逻辑，无需依赖队列推送环节。

注意事项 #

• 若任务依赖数据库、外部API等服务，需在测试中提前准备好对应数据或模拟这些依赖。
• 若使用了队列中间件或任务链，需确保手动执行任务时相关依赖能正常工作。

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