队列状态与故障排查

观察等待消息、未确认消息和消费者数量,结合任务日志判断下一步该查哪里。

🎯 引言

任务已经提交,订单却迟迟没有完成:是没有消费者领取,还是领取后处理太慢?本篇用队列中的三个数字缩小排查范围,再结合支付编号和程序日志检查原因。


🧰 查看队列的三个数字

确认 Docker 和课程的 rabbitmq-course 容器正在运行,在终端执行:

docker exec rabbitmq-course rabbitmqctl list_queues \
    name messages_ready messages_unacknowledged consumers

docker exec 在指定容器内执行命令;rabbitmqctl list_queues 查询队列,后面四个字段指定要显示的列。这条命令只读取状态,不会领取或删除消息。

输出列本文简称表示什么
name队列名这一行统计的是哪个队列
messages_readyReady还在等待投递的消息数
messages_unacknowledgedUnacked已经投递、RabbitMQ 尚未收到确认的消息数
consumersConsumers订阅这个队列的消费者数量

例如,输出中有这样一行:

name        messages_ready  messages_unacknowledged  consumers
work.order  1               0                        0

这表示 work.order 有一条消息等待领取,目前没有消费者。Consumers 统计订阅数;本课程每个 worker 只有一个订阅,所以两个 worker 对应 2。

下面沿用课程默认连接配置,只观察 work.order 那一行;若尚未建立这个队列,先完成下一节的发送步骤。字段定义见 rabbitmqctl 文档。

命令行参数与输出格式可能随版本变化。本篇按课程的 RabbitMQ 4.1 环境说明,使用其他版本时以对应版本的帮助信息为准。

🛠 用一条任务观察状态变化

沿用消费确认篇的 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”后再查询一次:

查询时机ReadyUnackedConsumers
已发送,尚未启动 worker100
已打印“开始”,仍在等待三十秒011
服务端收到确认后,worker 继续运行001

最后 Consumers 仍为 1,因为程序处理完这条任务后仍在等待下一条。每次命令只显示查询时的状态,不会持续更新;需要观察变化时重新执行。如果错过处理中那一刻,换新编号再观察,不必修改确认代码。

这些数量只描述队列状态,不是订单处理记录。实际业务是否完成,还要根据支付编号查业务结果,不能仅凭 Ready 和 Unacked 都为 0 下结论。


🔎 根据状态选择检查方向

有等待消息,但没有消费者

Ready 大于 0、Consumers 为 0,说明这个队列目前没人领取。先查看 worker 终端是否仍在运行、是否报连接错误,再核对是否连接了本课程的 RabbitMQ、订阅的队列名是否为 work.order。连接问题按安装与连接篇的步骤检查。

有消费者,但等待消息越来越多

Consumers 大于 0 只能说明订阅还在,不能证明处理正常。先看是否持续出现不同任务的“完成”日志:

  • 一直有任务完成,但 Ready 仍持续增长:可能是新任务到达得更快。比较单位时间内发送和完成的数量,再考虑增加处理能力。
  • 长时间没有任务完成:先查消费者卡在哪里。若已占满预取数量,RabbitMQ 会等待确认,不会继续给它投递。

不要只看到堆积就增加实例;若原因是数据库或短信接口变慢,更多请求可能加重问题。

Unacked 一直不为零

先看当前任务是否超过平时的处理时间,再看日志中的任务编号有没有变化。持续消费时,旧消息被确认、新消息又被领取,Unacked 可能一直保持同一个数,不能据此认定卡住。

如果同一条任务长时间没有完成,再检查业务调用是否一直等待、是否有异常,以及成功后是否执行了 ack。必要时对照消费确认篇检查确认位置。

队列已经为空,但业务结果没有出现

按这条任务的支付编号检查三处证据:

  1. 生产者的发布确认与退回结果:服务端是否接受发布,消息是否因无法路由被退回。
  2. 消费者日志:有没有收到该编号,最后是确认、拒绝还是发生错误。
  3. 业务记录与对应的死信队列:业务是否实际完成,任务是否被转走。

查询对象必须与业务一致:订单示例看 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),下次启动生效。


🎉 你已经能用队列状态确定检查方向,再结合具体任务的记录定位原因了!