ThinkPHP 6 队列任务不执行 supervisor 报错怎么排查修复

现象

ThinkPHP 6 项目用 queue 投递任务,接口返回成功,redis 里能看到对应 list 有数据,队列长度一直往上涨,后台的任务状态永远停在等待中,日志里没有任何执行记录,重启服务器也没有变化。

原因

最常见的是根本没有启动 worker 进程,投递成功但没人消费;Supervisor 配置里 Command 写成了相对路径,或者调用了另一个版本的 PHP,进程起来就退出,反复重启;worker 启动后代码里有致命错误,日志没开所以看不到;投递时指定的队列名与消费时的 queue 参数不一致;改了业务代码没有重启 worker,进程还在跑旧字节码。

解决步骤

第一步,手动跑一次消费命令。前台执行 queue:work,加上 -v 看详细输出,能直接暴露类找不到、扩展缺失、数据库连不上这类启动错误。

php think queue:work --queue=default --tries=3 -v
tail -n 40 runtime/log/queue.log
supervisorctl status blog-queue

第二步,把 supervisor 配置写规范。command 用 PHP 的绝对路径加项目绝对路径,directory 指到项目根,stdout_logfile 单独给一个文件,autostart 与 autorestart 都设成 true,改完 supervisorctl update 让配置生效。

第三步,改完代码重启消费者。队列进程常驻内存,发布新代码后必须 queue:restart,让 worker 处理完当前任务后退出并由 supervisor 拉起新进程。

验证

投递一条测试任务,几秒内状态变为完成,list 长度回落,supervisor 显示进程 RUNNING。

小结

队列不执行先区分是没人消费还是消费即崩。手动跑一次拿到真实报错,再用 supervisor 托管并用绝对路径启动,最后记得改代码要重启 worker。

您可以还会对下面的文章感兴趣: