如何判断队列任务已耗尽所有重试次数？支付状态同步问题

核心思路 #

利用Laravel Job内置的重试次数判定逻辑，仅在任务耗尽所有重试机会彻底失败时记录失败状态；同时用updateOrCreate替代create，保证每笔支付只会生成一条状态记录，避免重复创建。

步骤1：明确Job的最大重试次数 #

在PaymentJob类中显式声明最大重试次数（和队列全局配置保持一致即可，显式声明更直观）：

class PaymentJob implements ShouldQueue
{
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;

    protected $payment;
    // 最大重试次数，和你的队列配置匹配
    public $tries = 3;

    public function __construct(Payment $payment)
    {
        $this->payment = $payment;
    }

    // 后续方法写在这里
}

步骤2：修改handle方法，确保成功状态唯一 #

生成PDF后，用updateOrCreate替代create，不管任务是否重试过，最终只会保留一条成功状态：

public function handle()
{
    // 执行生成PDF的业务逻辑
    // ...

    // 创建或更新支付状态为成功
    $this->payment->status()->updateOrCreate(
        [], // 无查询条件，确保每个Payment对应唯一一条Status记录
        ['status' => 'success']
    );
}

步骤3：修改failed方法，仅在最后一次失败时记录状态 #

通过$this->attempts()获取当前尝试次数，只有当次数等于最大重试次数时，才创建失败状态：

public function failed(Throwable $exception)
{
    // 仅当耗尽所有重试次数时，才标记为失败
    if ($this->attempts() === $this->tries) {
        $this->payment->status()->updateOrCreate(
            [],
            ['status' => 'error']
        );
    }
}

补充说明 #

• $this->attempts()返回当前任务的尝试次数（从1开始计数），当任务第3次失败时，该值等于$tries，此时触发失败状态记录。
• updateOrCreate会先查找关联的PaymentStatus记录，不存在则创建，存在则更新状态，确保每笔支付始终只有一条状态记录。

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