消息队列 / 系统课时

消息发出了却找不到怎么排查

消息发出了却找不到怎么排查

发布端显示调用成功,却在目标队列里找不到消息时,应把链路拆成 Publisher、Exchange、Binding、Queue 四段逐层检查。重点不是先怀疑消息丢失,而是确认消息究竟发布到了哪里、是否满足路由条件,以及不可路由时客户端有没有接住返回结果。

学习目标

  • 按 vhost、Exchange、Routing Key、Binding、Queue 的顺序定位消息路由问题
  • 根据 Exchange 类型判断 Routing Key 是否能够命中目标 Binding
  • 理解 mandatory 返回与 Publisher Confirm 解决的是不同问题

先确认发布目标没有看错

RabbitMQ 的 Exchange、Queue 和 Binding 都属于 vhost。两个 vhost 中即使存在同名 Exchange,也属于完全不同的资源。因此发布成功但目标队列没有消息时,首先核对客户端连接的 vhost、发布的 Exchange 名称和 Routing Key。

如果 Exchange 名称不存在,通常会导致发布所在 Channel 被 Broker 关闭;如果 Exchange 存在但没有任何 Binding 能匹配该消息,则消息可能成为不可路由消息。后者尤其容易被误认为“RabbitMQ 把消息弄丢了”。

检查 Exchange 和 Binding

在 Broker 节点上可以直接列出 Exchange 和 Binding。下面假设需要检查默认 vhost /;实际环境使用其他 vhost 时,应替换 -p 参数后的值。

bash
rabbitmqctl list_exchanges -p / name type
rabbitmqctl list_bindings -p / source_name source_kind destination_name destination_kind routing_key

预期输出:实际名称和 Binding 数量取决于当前环境,下面只展示需要核对的字段关系。

text
<EXCHANGE_NAME>    direct
<EXCHANGE_NAME>    exchange    <QUEUE_NAME>    queue    <ROUTING_KEY>

如果第一条命令里找不到发布端使用的 Exchange,应先核对 vhost 和部署配置。如果 Exchange 存在,则继续确认 Binding 的源 Exchange、目标 Queue 和 Routing Key 是否与发布端预期一致。

按 Exchange 类型判断路由是否命中

不同 Exchange 的路由规则不同,不能只看“Binding 存在”就认为消息一定会进入队列。direct 要求消息的 Routing Key 与 Binding Key 精确匹配;topic 按单词和 *、# 通配规则匹配;fanout 会向已绑定队列广播,通常不依赖 Routing Key;headers 则根据消息头属性匹配。

RabbitMQ 消息从发布到队列的路由排查图

对于默认 Exchange 还要单独注意:它的名称是空字符串,RabbitMQ 会按照 Routing Key 查找同名队列。此时如果 Routing Key 写错,即使队列本身存在,也不会进入预期队列。

用 mandatory 判断消息是否不可路由

AMQP 发布时可以启用 mandatory。当消息到达 Exchange,却无法路由到任何 Queue 时,mandatory=true 会让 Broker 通过 basic.return 把消息返回给 Publisher,客户端应注册对应的返回处理逻辑并记录 Exchange、Routing Key 和返回原因。

如果 mandatory=false,不可路由消息不会因为 Publisher Confirm 成功就自动进入某个队列;如果同时没有配置 Alternate Exchange,这类消息可能直接结束其路由过程。因此“发布方法没有报错”不能证明目标队列收到消息。

如果系统配置了 Alternate Exchange,则不可路由消息还可能被转交到备用交换机。排查时需要继续检查备用交换机的 Binding 和目标队列,否则消息可能不是消失,而是进入了另一条预先设计的路由链路。

从一条唯一测试消息完成验证

修复配置后,最好发布一条携带唯一业务标识 <ID> 的测试消息,并同时观察发布端返回处理和目标队列。不要只看某一瞬间的 messages_ready,因为在线消费者可能在监控刷新前就把消息取走。

验证应满足完整链路:发布端连接了正确 vhost,Exchange 存在,Routing Key 能命中预期 Binding,启用 mandatory 时没有收到该消息的 basic.return,并且最终能在目标消费者日志或业务结果中找到同一个 <ID>。这样才能证明问题已经从“调用成功”真正修复到“消息到达并被正确处理”。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

消息发出了却找不到怎么排查

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通