ThinkPHP队列任务失败后需结合日志配置、驱动类型与异常捕获定位问题：确保log.php开启error级别、runtime/log/可写，任务handle中手动记录Log::error；Database驱动查failed_jobs表（exception字段含base64堆栈），Redis驱动用redis-cli查queue:failed；重试用php think queue:retry {id}或all，并配public $tries=3及--tries参数。
ThinkPHP 队列任务执行失败后，日志查看和重试需结合框架配置、队列驱动（如 Redis、Database）、以及任务本身的异常捕获逻辑来定位。默认情况下 ThinkPHP 不自动记录队列任务的详细错误，需主动配置日志输出并启用失败重试机制。
一、确认队列日志是否开启并写入正确位置
ThinkPHP 的队列日志默认不单独归类，而是走统一日志通道。需检查以下几点：
-
确保日志级别包含 error 或 debug：在
config/log.php中确认'level' => ['error', 'info']或更高； -
检查日志写入路径是否可写：默认为
runtime/log/，确认该目录有写权限； -
队列任务中手动记录关键日志：在任务的
handle()方法开头加Log::info('Job started: '.get_class($this));，出错时用Log::error('Job failed: '.$e->getMessage(), ['trace' => $e->getTraceAsString()]);； -
开启队列运行时的详细输出：使用
php think queue:work --verbose启动，可实时看到异常堆栈。
二、查看失败任务的存储与原始错误信息
不同队列驱动保存失败任务的方式不同：
-
Redis 驱动：失败任务默认存入
queue:failed列表（键名可能含前缀），可用redis-cli lrange queue:failed 0 -1查看原始 JSON 数据，其中包含exception和failed_at字段； -
Database 驱动：需先启用失败表迁移：
php think queue:failed-table，然后查failed_jobs表，exception字段即完整报错内容（注意是序列化或 JSON 格式，部分版本会 base64 编码）； - 查看时注意时间范围：失败任务可能堆积，优先筛选最近 1 小时内的记录，避免误读过期任务。
三、手动重试失败任务的方法
ThinkPHP 自带命令支持对已失败任务进行重试：
立即学习“PHP免费学习笔记（深入）”；
-
重试单个任务：获取失败 ID（如数据库中的
id或 Redis 中 JSON 的id字段），执行php think queue:retry {id}； -
重试全部失败任务：
php think queue:retry all（慎用，建议先备份failed_jobs表）； -
重试并限制最大尝试次数：可在任务类中设置
public $tries = 3;，或启动时指定--tries=3； -
跳过特定失败任务：用
php think queue:forget {id}清除不再处理的任务。
四、预防再次失败的关键配置
光重试不够，要减少重复失败：
- 在任务中捕获异常并明确处理：避免未 catch 的致命错误直接导致失败；
-
设置超时时间：在
config/queue.php中配置'timeout' => 60，防止卡死； - 避免在任务中使用 $this->app 等易失效的上下文对象：推荐依赖注入所需服务，而非运行时动态获取；
-
数据库连接问题常见：任务长时间运行可能导致连接断开，建议在 handle 中调用
Db::connect()->ping();或使用Db::table()->...->failException(true)显式抛错。
不复杂但容易忽略的是：很多失败源于环境差异（如本地能跑、生产缺扩展或配置），务必在相同环境下复现并查日志。
