Laravel 12任务重试由队列系统自动触发,支持多层配置(任务实例>命令行>驱动默认)、线性/指数退避策略、死信队列归档及多模态上下文智能降级。

在 Laravel 12 中,任务重试不是靠“手动补发”或“写个循环”,而是由队列系统在失败时自动触发的机制,核心在于配置、策略和可观测性三者的配合。它既支持简单场景下的固定重试,也支持高阶场景下的动态退避与死信隔离。
重试配置方式:从命令行参数到队列驱动级设置
重试行为可多层控制,优先级从高到低依次为:任务实例 > 队列命令参数 > 驱动默认值。
- 在分发任务时直接指定重试次数:
dispatch(new SendWelcomeEmail())->onConnection('redis')->onQueue('emails')->tries(3); - 启动 worker 时统一设置(适用于整条队列):
php artisan queue:work redis --tries=3 --timeout=90 - 在
config/queue.php中为特定连接预设重试策略,例如 Redis 连接可配置:'redis' => [<br> 'driver' => 'redis',<br> 'connection' => 'default',<br> 'retry_strategy' => 'exponential_backoff', // 或 'linear'<br> 'max_retries' => 5<br>],
重试策略类型:线性 vs 指数退避
Laravel 12 内置两种主流策略,区别在于失败后再次尝试的时间间隔是否递增:
- 线性退避(linear):每次重试间隔固定,比如都等 3 秒。适合对时效敏感但失败原因较稳定(如临时网络抖动)的任务。
- 指数退避(exponential_backoff):间隔按 2ⁿ 增长(如 1s → 2s → 4s → 8s)。Laravel 12 默认启用该策略,能有效缓解下游服务雪崩风险,尤其适合调用第三方 API 或 AI 推理类任务。
你也可以自定义策略类,实现基于错误码、响应头或历史失败率的智能退避逻辑。
失败任务归档与死信队列(DLQ)
当任务重试耗尽仍失败,Laravel 12 会将其自动移入死信队列(Dead Letter Queue),避免无限堆积和掩盖真实问题。
- 启用 DLQ 需在队列配置中显式开启:
'failed' => ['table' => 'failed_jobs', 'retry_after' => 3600](数据库驱动)或使用 Redis Stream 的xadd+dlqchannel(Redis 驱动) - 所有失败任务记录包含完整异常堆栈、原始载荷、失败时间、重试次数,可通过
php artisan failed:show {id}查看详情 - 支持一键重试:
php artisan failed:retry all,或按条件筛选重试:php artisan failed:retry --only=SendNotificationJob
与多模态队列联动的重试增强
在 Laravel 12 多模态架构下,重试不再只是“再跑一遍”,而是可结合任务上下文智能决策:
- AI 推理任务失败时,自动降级到更宽松的模型或缓存兜底响应
- 支付回调失败超过 3 次,自动切换至 SQS 队列并触发告警通知运维
- 实时消息类任务(如 WebSocket 广播)失败后不重试,而是直接写入离线推送通道
这些行为通过 shouldRetryOn($exception) 和 failed() 方法在任务类中声明,配合 Horizon 或自定义监控看板,实现失败可追溯、重试可干预、归档可治理。


















