应使用Supervisor监控并自动重启队列进程、Redis命令行检查队列长度、ThinkPHP内置监控命令暴露HTTP接口、解析队列日志文件、结合系统级进程与端口检测五种方法综合监控ThinkPHP队列状态。
如果您在运行ThinkPHP应用时发现队列任务积压、执行中断或消费者无响应，则可能是由于队列进程异常退出或资源阻塞所致。以下是监控ThinkPHP队列状态的多种方法：
一、使用Supervisor监控并自动重启队列进程
Supervisor可将thinkphp queue:listen或queue:work命令作为守护进程运行，并在进程崩溃时自动拉起，保障队列服务持续可用。
1、安装Supervisor：执行yum install -y epel-release supervisor（CentOS）或apt-get install supervisor（Ubuntu）。
2、创建Supervisor配置文件/etc/supervisord.d/thinkphp-queue.ini，内容如下：
立即学习“PHP免费学习笔记（深入）”；
[program:thinkphp-queue]
command=php /var/www/your-project/think queue:work --daemon
directory=/var/www/your-project
user=www
autostart=true
autorestart=true
startretries=3
redirect_stderr=true
stdout_logfile=/var/log/thinkphp-queue.log
3、重载Supervisor配置：执行supervisorctl reread && supervisorctl update。
4、启动队列进程：supervisorctl start thinkphp-queue，并用supervisorctl status确认运行状态。
二、通过Redis命令行实时检查队列长度与积压情况
当使用Redis作为队列驱动时，队列本质是List结构，可通过原生命令快速获取待处理任务数量，判断是否存在积压。
1、连接Redis服务器：redis-cli -h 127.0.0.1 -p 6379（若配置密码需加-a your_password）。
2、查询默认队列长度：llen default（若配置了其他队列名，请替换为实际名称，如llen email_queue）。
3、查看延迟队列（如有）：zcard delay_queue（适用于基于Sorted Set实现的延迟队列）。
4、若返回值持续增长且无下降趋势，说明消费者进程未正常消费或已停止，需立即排查进程状态。
三、启用ThinkPHP内置队列监控命令并提供HTTP接口
通过自定义Artisan命令暴露队列运行时信息，支持脚本化轮询或集成至运维平台。
1、在app/command/下创建QueueMonitor.php，实现getMonitorInfo()逻辑，返回当前队列连接、任务数、失败任务数、最近失败ID等字段。
2、在app.php中注册该命令：'commands' => [app\command\QueueMonitor::class]。
3、添加路由Route::get('/api/queue/status', 'queue/monitor')，控制器中调用Artisan::call('queue:monitor')并输出JSON。
4、访问http://your-domain.com/api/queue/status即可获取结构化队列状态，其中failed_jobs > 0 且 retry_after 超期表示存在需人工干预的失败任务。
四、解析队列日志文件定位执行异常
ThinkPHP队列任务执行过程中的异常、超时、重试均会写入日志，是诊断问题最直接的依据。
1、确保config/queue.php中已开启日志记录，例如在connections.redis.options下添加'log' => true（部分扩展支持）。
2、手动在任务类fire()方法中插入日志：Log::info('Job started', ['job_id' => $job->getJobId()]);。
3、实时追踪日志：tail -f runtime/log/queue/*.log，重点关注包含Exception、failed、timeout的行。
4、若发现某类任务反复失败，应检查对应Job类中数据库连接是否被复用、事务是否未提交、外部API是否不可达。
五、结合系统级进程与端口检测验证消费者存活
即使Supervisor显示进程运行中，也可能因僵死、假死或端口占用导致无法消费，需多维度交叉验证。
1、检查PHP进程是否存在：ps aux | grep 'queue:work' | grep -v grep，确认输出中包含有效PID及完整命令路径。
2、验证进程是否响应信号：kill -0 [PID]，若返回错误则进程已僵死。
3、若使用--port参数启动监听（如Workerman场景），执行lsof -i :[PORT]确认端口被正确绑定。
4、若进程存在但无日志输出、队列不减少，极可能处于无限循环、内存溢出或协程挂起状态，需配合strace -p [PID]进一步分析系统调用。
