supervisor可解决thinkphp队列进程意外终止问题，需完成服务安装配置、编写专属ini文件、设置autorestart=true/stopwaitsecs=120等保活参数、重定向stderr输出、宝塔面板五项校验。
如果您在ThinkPHP项目中启动了队列消费进程（如php think queue:work），但该进程在后台运行一段时间后意外终止且未自动恢复，则很可能是缺乏有效的Supervisor守护配置。以下是实现Supervisor对ThinkPHP队列进程稳定保活的具体设置步骤：
一、确认Supervisor服务已正确安装并运行
Supervisor必须处于活动状态，才能对PHP进程进行监控与拉起。需确保其作为系统服务已启用并正在运行，否则后续所有配置均无法生效。
1、执行yum install -y epel-release supervisor（CentOS/RHEL）或apt-get install -y supervisor（Ubuntu/Debian）完成安装。
2、生成默认主配置文件：echo_supervisord_conf > /etc/supervisord.conf。
3、编辑/etc/supervisord.conf，在文件末尾添加包含指令：[include]与files = /etc/supervisord.d/*.ini。
4、启动并设为开机自启：systemctl enable supervisord && systemctl start supervisord。
5、验证运行状态：systemctl status supervisord，输出应显示active (running)。
二、编写独立的Supervisor进程配置文件
每个ThinkPHP队列进程必须拥有专属的INI配置，明确指定启动路径、用户权限、重启策略及日志位置，避免多进程配置冲突或权限越界。
1、在/etc/supervisord.d/目录下新建文件，例如tp6-queue.ini。
2、填入以下内容（请按实际路径与环境替换变量）：
3、确保command使用绝对路径调用PHP和think命令，例如：/www/server/php/82/bin/php /www/wwwroot/myapp/think queue:work --daemon --memory=128 --sleep=3。
4、设置directory为项目根目录（即含think可执行文件的路径），例如：/www/wwwroot/myapp。
5、指定user为非root低权限用户（如www），禁止使用root运行PHP应用进程。
6、配置日志路径：stdout_logfile=/var/log/supervisor/tp6-queue-out.log与stderr_logfile=/var/log/supervisor/tp6-queue-err.log，确保错误可追溯。
三、关键保活参数强制设定
默认Supervisor参数极易导致ThinkPHP队列进程被粗暴终止或误判退出，必须显式覆盖以下四项核心值，以匹配TP队列的优雅退出机制与内存行为。
1、设置autorestart=true，禁用unexpected模式，防止因单次warning日志触发无意义重启。
2、设置startretries=0，关闭启动重试次数限制，避免首次失败后永久停服。
3、设置stopwaitsecs=120，为SIGTERM信号预留充足收尾时间，确保当前任务执行完毕再退出。
4、设置stopasgroup=true与killasgroup=true，防止子进程残留造成资源泄漏或重复消费。
四、重定向stderr输出避免误触发重启
ThinkPHP在daemon模式下若将warning、notice或未捕获异常输出至stderr，Supervisor会将其判定为“非正常退出”，立即执行stop→start循环，形成高频闪退假象。
1、修改Supervisor配置中的command行，在末尾追加>> /var/log/tp-queue.log 2>&1，强制合并标准输出与错误输出至日志文件。
2、同步在queue.php中禁用控制台日志驱动，确保'default' => 'single'且'handler' => 'think\log\driver\File'。
3、检查failed任务驱动是否启用数据库或Redis，避免因失败表缺失导致静默失败并中断进程。
五、宝塔面板下的可视化配置要点
在宝塔环境中，Supervisor插件提供图形界面操作，但部分关键字段易被忽略或填写错误，须严格校验以下五项输入值。
1、进程名称仅允许英文、数字与下划线，例如tp6_queue_worker，禁止中文或空格。
2、“启动命令”栏必须粘贴完整绝对路径命令，不可省略PHP版本路径或使用~/、.等相对标识。
3、“运行目录”必须精确指向项目根目录（含think文件），而非public或app子目录。
4、“运行用户”必须选择www，若选root则Supervisor会拒绝启动并记录FATAL错误。
5、勾选“开机自启”与“进程异常退出时自动重启”，且在高级设置中手动展开，将“停止等待时间”改为120秒。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
