Laravel 10链式任务测试问题：指定队列时断言失败

问题根源在于Bus::assertChained()默认仅验证链式任务的类/实例顺序，不会校验每个任务的队列归属。当你用onQueue()给链式任务指定队列后，每个任务的queue属性会被设置，但默认断言逻辑不包含这层校验，导致断言失败。

以下是两种可行的解决方案，既能验证完整链式任务，又能确保任务被调度到指定队列：

方案一：手动验证链式任务的队列与顺序 #

直接通过Bus::dispatched()获取所有被调度的任务链，然后逐一检查任务的队列属性和顺序：

use Illuminate\Bus\Chain;

Bus::fake();

// 触发你的分片下载调度逻辑，比如调用对应服务的方法

// 筛选出所有链式任务
$chains = Bus::dispatched(fn ($job) => $job instanceof Chain);

// 假设当前测试只触发一条任务链，取第一条
$targetChain = $chains->first();

// 验证链中任务数量是否符合预期
$this->assertCount(3, $targetChain->jobs);

// 检查每个任务的队列是否正确
$this->assertEquals('downloads', $targetChain->jobs[0]->queue);
$this->assertEquals('downloads', $targetChain->jobs[1]->queue);
$this->assertEquals('downloads', $targetChain->jobs[2]->queue);

// 验证任务类的顺序是否正确
$this->assertInstanceOf(DownloadJob::class, $targetChain->jobs[0]);
$this->assertInstanceOf(DownloadJob::class, $targetChain->jobs[1]);
$this->assertInstanceOf(NotificationJob::class, $targetChain->jobs[2]);

方案二：封装自定义断言方法复用逻辑 #

如果你需要在多个测试中复用这个校验逻辑，可以在测试基类（比如TestCase.php）中封装一个自定义断言方法：

use Illuminate\Bus\Chain;

protected function assertChainedOnQueue(string $queue, array $expectedJobClasses)
{
    $matchingChain = Bus::dispatched(fn ($job) => $job instanceof Chain)
        ->filter(function (Chain $chain) use ($queue, $expectedJobClasses) {
            // 检查链中所有任务是否都在目标队列
            $allOnTargetQueue = collect($chain->jobs)->every(fn ($job) => $job->queue === $queue);
            if (!$allOnTargetQueue) {
                return false;
            }

            // 检查任务类顺序是否匹配预期
            $actualJobClasses = collect($chain->jobs)->map(fn ($job) => get_class($job))->all();
            $normalizedExpected = collect($expectedJobClasses)->map(fn ($class) => is_string($class) ? $class : get_class($class))->all();

            return $actualJobClasses === $normalizedExpected;
        })
        ->first();

    $this->assertNotNull($matchingChain, "未找到包含指定任务且调度到队列[{$queue}]的链式任务");
}

之后在测试中直接调用这个方法即可：

$this->assertChainedOnQueue('downloads', [
    DownloadJob::class,
    DownloadJob::class,
    NotificationJob::class,
]);

这两种方案都能完整验证链式任务的队列归属和执行顺序，覆盖你需要的测试场景。

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