如何解决ThinkPHP队列消费进程无故退出的问题_Supervisor守护进程与重启

老婷姑娘_8764

老婷姑娘_8764

2026-03-28

1079人浏览

原创

supervisor 下 php think queue:work 进程异常退出主因有三:stderr 输出触发 autorestart、daemon 模式内存溢出遭 oom kill、stopwaitsecs 过短致强制终止;需重定向日志、限制内存、调大 stopwaitsecs 并优化 retry_after。

如何解决thinkphp队列消费进程无故退出的问题_supervisor守护进程与重启

Supervisor 启动的 php think queue:work 进程突然消失

根本原因不是队列本身出错,而是 Supervisor 默认把标准错误(stderr)当作进程异常信号——只要 queue:work 输出了 warning、notice 或未捕获的异常日志到 stderr,Supervisor 就会判定进程“非正常退出”,触发 stop → start 循环,造成“无故退出”的假象。

实操建议:

  • 在 Supervisor 配置中显式关闭 autorestart=unexpected 的敏感行为,改用 autorestart=true + startretries=0,避免因单次 stderr 输出误判
  • 强制将 ThinkPHP 的日志输出重定向到文件,不让它走 stderr:php think queue:work --daemon --quiet >> /var/log/tp-queue.log 2>&1
  • 检查 queue.php 配置里的 failed 驱动是否为 database 或 redis,避免因失败任务表缺失导致 silent fail

ThinkPHP queue:work 在 --daemon 模式下内存持续增长

这是最隐蔽的退出诱因:PHP 进程不重启,但内存涨到系统 OOM killer 触发时,进程会被强制 kill,Supervisor 只看到“退出码 -9”,查不到日志,误以为是代码崩溃。

实操建议:

  • 必须启用 --memory=128 参数(单位 MB),例如:php think queue:work --daemon --memory=128 --sleep=3
  • 不要依赖默认的 --delay=3,高并发下积压任务多,--sleep=3 能减少空转,降低内存驻留时间
  • 确认项目里没在闭包或事件监听器中长期持有大对象(如 DB 查询结果、Excel 导入缓存),这类泄漏在 daemon 模式下会逐轮累积

Supervisor 配置里 stopwaitsecs 太小导致强制 kill

ThinkPHP 的 queue:work 收到 SIGTERM 后,会等当前任务执行完再退出;如果 stopwaitsecs 设为默认的 10 秒,而某个任务耗时 15 秒,Supervisor 就会发 SIGKILL 强制终止——这不是异常退出,是配置不合理。

实操建议:

  • 把 stopwaitsecs 设为预估最长任务耗时的 2 倍,比如导出报表任务最多 60 秒,就设 stopwaitsecs=120
  • 配合使用 stopasgroup=true 和 killasgroup=true,防止子进程残留
  • 在 command 行末尾加 2>&1,确保所有输出进日志,否则 supervisorctl tail 看不到真实退出原因

重启后队列消费卡在“waiting for job”不动

常见于 Redis 驱动 + retry_after 设置过短,Supervisor 重启瞬间大量任务被标记为“超时失败”,又立刻被重推回队列,形成竞争和阻塞;或者数据库连接未释放,新进程拿不到可用 PDO 实例。

实操建议:

  • 检查 config/queue.php 中 redis.default.retry_after,生产环境建议 ≥ 3600(1 小时),避免频繁重试干扰
  • 在 queue:work 启动命令前加 php think queue:restart,清空旧的 worker 状态标识
  • 确认 database.connections.mysql.pdo 没被全局变量意外复用,ThinkPHP 6.1+ 推荐显式关闭长连接:'persistent' => false

真正麻烦的从来不是 Supervisor 配不配得上,而是 PHP 进程自己有没有“守规矩”:别让日志乱打 stderr,别让内存悄悄涨满,别让一个任务拖住整个退出流程。这些点漏掉任意一个,Supervisor 就只能当个背锅侠。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
mysql修改数据表名
mysql修改数据表名

MySQL修改数据表:1、首先查看数据库中所有的表,代码为:‘SHOW TABLES;’;2、修改表名,代码为:‘ALTER TABLE 旧表名 RENAME [TO] 新表名;’。php中文网还提供MySQL的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

2253

6

MySQL创建存储过程
MySQL创建存储过程

存储程序可以分为存储过程和函数,MySQL中创建存储过程和函数使用的语句分别为CREATE PROCEDURE和CREATE FUNCTION。使用CALL语句调用存储过程智能用输出变量返回值。函数可以从语句外调用(通过引用函数名),也能返回标量值。存储过程也可以调用其他存储过程。php中文网还提供MySQL创建存储过程的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.21

1379

5

mongodb和mysql的区别
mongodb和mysql的区别

mongodb和mysql的区别:1、数据模型;2、查询语言;3、扩展性和性能;4、可靠性。本专题为大家提供mongodb和mysql的区别的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.18

815

5

mysql密码忘了怎么查看
mysql密码忘了怎么查看

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql密码忘了怎么办呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.19

3132

5

mysql创建数据库
mysql创建数据库

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql怎么创建数据库呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.25

5308

4

mysql默认事务隔离级别
mysql默认事务隔离级别

MySQL是一种广泛使用的关系型数据库管理系统,它支持事务处理。事务是一组数据库操作,它们作为一个逻辑单元被一起执行。为了保证事务的一致性和隔离性,MySQL提供了不同的事务隔离级别。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

2023.08.08

1179

3

sqlserver和mysql区别
sqlserver和mysql区别

SQL Server和MySQL是两种广泛使用的关系型数据库管理系统。它们具有相似的功能和用途,但在某些方面存在一些显著的区别。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.11

5571

4

mysql忘记密码
mysql忘记密码

MySQL是一种关系型数据库管理系统,关系数据库将数据保存在不同的表中,而不是将所有数据放在一个大仓库内,这样就增加了速度并提高了灵活性。那么忘记mysql密码我们该怎么解决呢?php中文网给大家带来了相关的教程以及其他关于mysql的文章,欢迎大家前来学习阅读。

2023.08.14

4882

7

mysql事务隔离级别
mysql事务隔离级别

mysql规范中定义了四种事务隔离级别,不同的隔离级别对事务的处理有所不同。本专题为大家提供mysql事务隔离级别相关的文章内容,大家可以免费体验。

2023.08.16

6474

11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.8万人学习