队列状态与故障排查
🎯 引言
任务已经提交,订单却迟迟没有完成:是没有消费者领取,还是领取后处理太慢?本篇用队列中的三个数字缩小排查范围,再结合支付编号和程序日志检查原因。
🧰 查看队列的三个数字
确认 Docker 和课程的 rabbitmq-course 容器正在运行,在终端执行:
docker exec rabbitmq-course rabbitmqctl list_queues \
name messages_ready messages_unacknowledged consumers
docker exec 在指定容器内执行命令;rabbitmqctl list_queues 查询队列,后面四个字段指定要显示的列。这条命令只读取状态,不会领取或删除消息。
| 输出列 | 本文简称 | 表示什么 |
|---|---|---|
name | 队列名 | 这一行统计的是哪个队列 |
messages_ready | Ready | 还在等待投递的消息数 |
messages_unacknowledged | Unacked | 已经投递、RabbitMQ 尚未收到确认的消息数 |
consumers | Consumers | 订阅这个队列的消费者数量 |
例如,输出中有这样一行:
name messages_ready messages_unacknowledged consumers
work.order 1 0 0
这表示 work.order 有一条消息等待领取,目前没有消费者。Consumers 统计订阅数;本课程每个 worker 只有一个订阅,所以两个 worker 对应 2。
下面沿用课程默认连接配置,只观察 work.order 那一行;若尚未建立这个队列,先完成下一节的发送步骤。字段定义见 rabbitmqctl 文档。
🛠 用一条任务观察状态变化
沿用消费确认篇的 send-work.mjs 和 worker.mjs。先让旧任务处理结束,再停止所有 worker。保持 prefetch(1),临时把 delay(5000) 改为 delay(30000),用三十秒等待模拟处理耗时,留足查询状态的时间。
终端一发送任务,再执行上面的队列查询命令,查看 work.order 那一行:
node send-work.mjs P6001
确认 Ready 为 1、Unacked 为 0、Consumers 为 0 后,在终端二启动消费者:
node worker.mjs
终端二出现“开始 P6001”后,在三十秒内回到终端一执行队列查询命令;出现“完成 P6001”后再查询一次:
| 查询时机 | Ready | Unacked | Consumers |
|---|---|---|---|
| 已发送,尚未启动 worker | 1 | 0 | 0 |
| 已打印“开始”,仍在等待三十秒 | 0 | 1 | 1 |
| 服务端收到确认后,worker 继续运行 | 0 | 0 | 1 |
最后 Consumers 仍为 1,因为程序处理完这条任务后仍在等待下一条。每次命令只显示查询时的状态,不会持续更新;需要观察变化时重新执行。如果错过处理中那一刻,换新编号再观察,不必修改确认代码。
这些数量只描述队列状态,不是订单处理记录。实际业务是否完成,还要根据支付编号查业务结果,不能仅凭 Ready 和 Unacked 都为 0 下结论。
🔎 根据状态选择检查方向
有等待消息,但没有消费者
Ready 大于 0、Consumers 为 0,说明这个队列目前没人领取。先查看 worker 终端是否仍在运行、是否报连接错误,再核对是否连接了本课程的 RabbitMQ、订阅的队列名是否为 work.order。连接问题按安装与连接篇的步骤检查。
有消费者,但等待消息越来越多
Consumers 大于 0 只能说明订阅还在,不能证明处理正常。先看是否持续出现不同任务的“完成”日志:
- 一直有任务完成,但 Ready 仍持续增长:可能是新任务到达得更快。比较单位时间内发送和完成的数量,再考虑增加处理能力。
- 长时间没有任务完成:先查消费者卡在哪里。若已占满预取数量,RabbitMQ 会等待确认,不会继续给它投递。
不要只看到堆积就增加实例;若原因是数据库或短信接口变慢,更多请求可能加重问题。
Unacked 一直不为零
先看当前任务是否超过平时的处理时间,再看日志中的任务编号有没有变化。持续消费时,旧消息被确认、新消息又被领取,Unacked 可能一直保持同一个数,不能据此认定卡住。
如果同一条任务长时间没有完成,再检查业务调用是否一直等待、是否有异常,以及成功后是否执行了 ack。必要时对照消费确认篇检查确认位置。
队列已经为空,但业务结果没有出现
按这条任务的支付编号检查三处证据:
- 生产者的发布确认与退回结果:服务端是否接受发布,消息是否因无法路由被退回。
- 消费者日志:有没有收到该编号,最后是确认、拒绝还是发生错误。
- 业务记录与对应的死信队列:业务是否实际完成,任务是否被转走。
查询对象必须与业务一致:订单示例看 work.order;通知示例看 notice.tasks 和 notice.dead-queue。work.order 没有配置通知的死信路径,不应到通知队列寻找订单任务。
❓ 知识问答
Q1:查不到队列,等于它没有消息吗?
不是。“队列存在且数量为零”和“队列不存在”是两种情况。先确认查询的是程序所连接的 RabbitMQ、队列名是否正确,再检查准备程序是否成功执行。
Q2:队列状态能指出具体哪个支付编号出问题吗?
不能,这些是汇总数量。要定位某一条任务,需要用支付编号查生产者、消费者日志和业务记录。
🧪 小练习
等上一条任务处理完,再停止 worker。保留三十秒等待和预取为 1,发送两条新任务:
node send-work.mjs P6011
node send-work.mjs P6012
先执行队列查询命令,再启动一个 worker,在第一条等待期间及两条全部完成后分别重新查询。没有旧消息时,预期 Ready/Unacked/Consumers 依次为 2/0/0、1/1/1、0/0/1。
说明为什么第一条处理期间 Ready 仍为 1,却不表示消费者发生了故障。实验结束后停止 worker,将等待恢复为 delay(5000),下次启动生效。
🎉 你已经能用队列状态确定检查方向,再结合具体任务的记录定位原因了!
