Laravel 11.29.0：如何在嵌套作业链完成后执行后续操作

你当前的写法中，MasterJob作为队列作业，其handle方法仅触发了内部子作业链的调度，并未等待子链完成就执行结束。因此Bus::chain会判定MasterJob已执行完毕，直接触发后续闭包，而内部的JobOne/JobTwo/JobThree仍在队列异步执行，导致闭包提前运行。

方案一：让MasterJob返回内部子链，合并到外部主链 #

修改MasterJob的handle方法，返回内部作业链。Laravel队列会自动在MasterJob执行后，先完成子链所有作业，再执行外部链的闭包：

class MasterJob implements ShouldQueue
{
    public function handle(): \Illuminate\Bus\PendingChain
    {
        return Bus::chain([
            new JobOne(),
            new JobTwo(),
            new JobThree(),
        ]);
    }
}

外部调用方式保持不变：

Bus::chain([
    new MasterJob(),
    function () {
        // jobs done - do some things ...
    }
])->dispatch();

方案二：将闭包作为参数传入MasterJob，追加到内部子链末尾 #

若需灵活传递后续逻辑，可修改MasterJob接收后续作业（或闭包）作为参数，在内部子链最后追加该逻辑：

class MasterJob implements ShouldQueue
{
    public function __construct(public mixed $finalAction = null)
    {
    }

    public function handle(): void
    {
        $chain = [
            new JobOne(),
            new JobTwo(),
            new JobThree(),
        ];

        // 传入后续逻辑则追加到子链末尾
        if ($this->finalAction) {
            $chain[] = $this->finalAction;
        }

        Bus::chain($chain)->dispatch();
    }
}

外部调用时直接传递闭包或作业实例：

// 传递闭包（需确保队列驱动支持闭包序列化）
Bus::dispatch(new MasterJob(function () {
    // jobs done - do some things ...
}));

// 推荐：使用具体作业类替代闭包，避免序列化异常
Bus::dispatch(new MasterJob(new class implements ShouldQueue {
    public function handle()
    {
        // jobs done - do some things ...
    }
}));

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