Laravel 8批量任务Bus::batch的finally回调偶发不执行问题

写法正确性判断 #

你的调用写法符合Laravel 8批量任务的官方规范，没有语法错误。
按照Laravel的设计逻辑，finally回调确实应该在批量任务所有子任务执行结束后触发，不管任务全部成功、部分失败（即使开启了allowFailures()）还是手动取消批次，都会触发该回调。

偶发不触发的常见原因 #

• 队列进程异常终止：比如队列worker被强制kill、服务器宕机、任务内存溢出导致进程退出，批次执行中断，没有走到回调触发逻辑
• 批次记录提前被清理：Laravel的批次状态存储在job_batches数据表中，如果你配置了旧批次清理的定时任务，清理时机早于批次执行完成，会导致框架无法匹配到对应批次，无法触发回调
• Laravel 8版本bug：8.x的早期版本存在批次计数异常的已知问题，当子任务重试次数超过上限、或者任务状态更新出现竞态时，会导致批次永远卡在待完成状态，不会触发收尾回调
• 队列驱动异常：比如Redis驱动出现键丢失、数据库驱动出现死锁导致队列任务丢失，也会导致回调无法触发

确保回调稳定执行的方案 #

• 升级Laravel 8到最新的8.x稳定小版本，官方已经修复了多个批次状态更新的相关bug
• 增加卡住批次巡检的定时任务，手动触发回调，示例代码如下：

// 放在app/Console/Commands里的定时任务代码
$stuckBatches = \Illuminate\Support\Facades\DB::table('job_batches')
    ->whereNull('finished_at')
    ->whereNull('cancelled_at')
    ->where('created_at', '<', now()->subHours(12)) // 可根据你的业务最长执行时间调整超时阈值
    ->get();

foreach ($stuckBatches as $batchRecord) {
    $batch = \Illuminate\Support\Facades\Bus::findBatch($batchRecord->id);
    if ($batch) {
        // 取消超时的卡住批次，会自动触发catch和finally回调
        $batch->cancel();
    }
}

• 调整旧批次清理策略：禁止清理创建时间小于7天的批次记录，确保所有批次执行完成前状态不会丢失
• 用Supervisor托管队列worker进程，配置内存上限、超时自动重启，避免进程意外挂掉
• 增加业务层兜底校验：比如你当前的业务是处理feed数据，可增加定时任务检测对应feed的处理状态，超过预期处理时间还未完成的，手动执行finally中定义的业务逻辑

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