使用 Laravel 的 Queue::assertPushed(JobClass::class, $times) 可精准断言某任务被推入队列的确切次数，配合 Queue::fake() 即可高效完成单元测试。
使用 laravel 的 `queue::assertpushed(jobclass::class, $times)` 可精准断言某任务被推入队列的确切次数，配合 `queue::fake()` 即可高效完成单元测试。
在 Laravel 测试中，验证一个队列任务是否被推送恰好 N 次是常见但易出错的需求。许多开发者误以为多次调用 Queue::assertPushed(SomeJob::class) 能实现“断言推送 5 次”的效果，但实际上该写法仅验证任务至少被推送过一次，重复调用不会叠加计数——因此无论实际推送 1 次还是 10 次，测试均会通过。
✅ 正确做法是：在 Queue::fake() 后，直接传入期望次数作为第二个参数：
use Illuminate\Support\Facades\Queue;
use Tests\TestCase;
class JobDispatchTest extends TestCase
{
public function test_job_is_pushed_exactly_five_times()
{
Queue::fake(); // 拦截所有队列操作，不真实执行
// 触发业务逻辑（例如：批量处理用户、发送通知等）
foreach (range(1, 5) as $i) {
dispatch(new SendWelcomeEmail($i));
}
// ✅ 断言 SendWelcomeEmail 被精确推送 5 次
Queue::assertPushed(SendWelcomeEmail::class, 5);
// ❌ 错误写法（以下断言均无效，且冗余）：
// Queue::assertPushed(SendWelcomeEmail::class);
// Queue::assertPushed(SendWelcomeEmail::class);
// Queue::assertPushed(SendWelcomeEmail::class);
// ……（重复 5 次仍只校验“至少 1 次”）
}
}⚠️ 注意事项：
- Queue::assertPushed(Job::class, $count) 严格校验推送次数等于 $count，少一次或多一次都会导致测试失败；
- 若需校验任务参数，可结合闭包断言：
Queue::assertPushed(SendWelcomeEmail::class, 3, function ($job) { return $job->userId === 123 && $job->template === 'welcome_v2'; }); - 使用 Queue::assertNothingPushed() 可辅助验证无意外任务入队；
- 记得在每个测试方法中独立调用 Queue::fake()，避免测试间状态污染。
掌握这一简洁而强大的断言方式，能显著提升队列相关逻辑的测试覆盖率与可靠性。
