Laravel中人工重试队列失败任务需使用php artisan queue:retry命令，支持单个ID或all重试，自定义连接需指定--queue参数；Horizon和Telescope仅监控不支持重试，Web重试需自行开发鉴权接口并防范序列化丢失、环境不一致等风险。

队列任务失败后，如何在 Laravel 中人工重试

默认情况下，Laravel 队列任务失败后会被丢进 failed_jobs 表，但不会自动重试——必须手动干预。Laravel 自带的 php artisan queue:retry 命令是核心入口，管理界面只是它的 Web 封装。

• 先确保已运行 php artisan queue:failed 查看失败记录，确认 id 和 connection（比如 redis 或 database）
• 重试单个任务：执行 php artisan queue:retry 123（123 是 failed_jobs.id）
• 重试全部失败任务：php artisan queue:retry all，慎用——可能触发重复支付、重复通知等副作用
• 如果用了自定义连接（如 redis），需加 --queue=redis 参数，否则默认走 sync 或配置里的 default

Laravel Horizon 或 Telescope 能不能直接重试？

Horizon 提供了 Web 界面查看失败任务，但**不支持点击重试**；Telescope 默认也不提供重试操作。它们只做监控和日志，底层仍要调用 queue:retry 命令或自己写接口。

Laravel Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

• Horizon 的失败页只有「Delete」按钮，没有「Retry」——这是故意设计，避免误操作
• 若需要 Web 点击重试，得自己基于 FailedJobProvider 和 QueueManager 写一个控制器方法，调用 retryFailed 方法
• 注意权限控制：该接口必须鉴权，且建议限制 IP 或仅限本地访问，防止被恶意调用

重试时常见的坑：参数丢失、环境不一致、死循环

重试不是简单“再跑一遍”，任务重建时会反序列化原始数据，但某些上下文（如请求对象、临时文件路径、闭包）无法还原，容易出错。

• 不要在任务中引用 $request、$_SERVER 或未序列化的资源（如 cURL handler）
• 检查 failed_jobs.payload 字段是否过长或含二进制内容——MySQL 的 TEXT 类型可能截断，导致重试时 unserialize() 失败，报错 ErrorException: unserialize(): Error at offset
• 设置最大尝试次数（tries = 3）并配合 backoff，否则失败后立刻重试可能加重数据库压力或触发第三方接口限流
• 任务里不要写 dd() 或 exit，它们会让队列进程崩溃，导致后续任务卡住

要不要自己写管理后台？还是用开源包？

官方没提供开箱即用的重试 UI，社区有轻量方案，但要注意维护成本和安全性。

• spatie/laravel-failed-job-monitor 只发告警，不提供重试界面
• laravel-queue-monitor 支持重试按钮，但需手动注册中间件和路由，且最新版对 Laravel 10+ 兼容性不稳定
• 最稳妥的方式是复用 Horizon 的前端结构，自己加一个 POST /horizon/retry/{id} 接口，内部调用 Artisan::call('queue:retry', ['id' => $id])
• 务必验证 $id 是否真实存在于 failed_jobs 表，且状态为 failed，避免 SQL 注入或越权重试

重试逻辑看着简单，真正上线时最容易栽在 payload 序列化完整性、连接配置错位、以及没设 tries 导致无限失败循环上。别信“点一下就恢复”的宣传，每个重试动作都该有日志、有确认、有回滚预案。