Laravel事务内Job无法调度：需仅在Job调度成功时提交事务

问题原因分析 #

你遇到的核心问题有两点：

1. 手动事务代码存在拼写错误：DB::rolleback()应为DB::rollBack()（注意B大写），这个错误会导致异常时无法正确回滚事务，事务处于挂起状态，进而让队列Job无法正常调度。
2. Laravel队列的afterCommit默认行为：在事务内调度Job时，Laravel默认会延迟Job的实际推送操作，直到事务成功提交后才执行。闭包式DB::transaction()会自动处理事务的提交/回滚流程，所以Job能在事务完成后正常调度，但手动事务因拼写错误破坏了这个流程。

修复后的手动事务代码 #

下面是修正后的代码，既保留手动控制事务的权限，又能确保Job成功调度后再提交事务：

DB::beginTransaction();
try {
    $notification = new MyNotification($data);
    $customJob = new CustomSendQueuedNotifications($notification);
    
    // 调度Job到指定队列
    $dispatchResult = dispatch($customJob)->onQueue('my-queue');
    
    // 可选：验证Job调度是否成功，按需添加
    if (!$dispatchResult) {
        throw new \RuntimeException('Job调度失败，终止事务');
    }
    
    Log::info('MyJob dispatched');
    // 确认Job调度成功后提交事务
    DB::commit();
} catch (\Throwable $th) {
    // 修复拼写错误，正确回滚事务
    DB::rollBack();
    throw $th;
}

额外优化选项 #

如果你需要不等待事务提交，立即调度Job（需确保Job执行时不依赖事务内未提交的数据），可以在调度时显式关闭afterCommit：

dispatch($customJob)->onQueue('my-queue')->afterCommit(false);

关键说明 #

• 手动事务必须严格保证commit和rollBack的拼写正确，否则会导致事务状态异常，直接影响队列Job的调度。
• 闭包式DB::transaction()虽然便捷，但确实无法手动控制提交时机，手动事务更适合需要自定义提交/回滚逻辑的场景。

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