Laravel怎么处理队列任务执行失败人工干预_Laravel提供管理界面重试【操作】-Laravel-PHP中文网

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

laravel怎么处理队列任务执行失败人工干预_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

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

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

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

Laravel Cloud

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

下载

不要在任务中引用 $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 注入或越权重试