消息队列 / 系统课时
消息为什么会变成不可路由
消息为什么会变成不可路由
生产者调用发布接口没有报错,只能说明消息已经按当前连接和信道发出,并不能证明它最终进入了目标队列。本节用一个 Direct Exchange 的最小实验拆开“发布”“路由”“入队”三个阶段,定位消息为什么会在交换机处失去去向。
学习目标
- 区分发布成功、交换机存在、路由匹配和消息入队几个不同结果
- 判断 Routing Key、Binding 与 Exchange 类型如何导致不可路由
- 用实际发布和取消息实验验证消息是否真正进入队列
发布成功不等于已经入队
RabbitMQ 的发布路径至少涉及 Producer、Exchange、Binding 和 Queue。生产者把消息发布到交换机时,需要提供交换机名称和 Routing Key;交换机再根据自身类型以及现有 Binding 判断消息应该进入哪些队列。

以 Direct Exchange 为例,只有 Routing Key 与某条 Binding Key 完全相等时,对应队列才会收到消息。如果交换机存在,但没有任何 Binding 能匹配当前消息,这条消息就是不可路由消息。
用一个错误 Routing Key 制造不可路由消息
下面示例假设本机 RabbitMQ 正在监听默认 AMQP 端口,并且 Python 环境已经安装 pika。程序创建 Direct Exchange 和队列,只绑定 order.created,随后故意使用 order.cancelled 发布消息。
import pika
connection = pika.BlockingConnection(
pika.ConnectionParameters(host="localhost")
)
channel = connection.channel()
exchange = "demo.route.direct"
queue = "demo.route.queue"
channel.exchange_declare(
exchange=exchange,
exchange_type="direct",
durable=False,
)
channel.queue_declare(queue=queue, durable=False)
channel.queue_bind(
exchange=exchange,
queue=queue,
routing_key="order.created",
)
# 避免前一次运行留下的消息影响验证结果。
channel.queue_purge(queue=queue)
channel.basic_publish(
exchange=exchange,
routing_key="order.cancelled",
body=b"order-1001",
mandatory=False,
)
method, properties, body = channel.basic_get(
queue=queue,
auto_ack=True,
)
print("publish call finished")
print("queue received:", "yes" if method else "no")
connection.close()预期输出
publish call finished
queue received: no发布调用能够正常结束,但队列中没有消息。原因不是网络断开,也不是消费者消费太快,而是 Direct Exchange 找不到 order.cancelled 对应的 Binding;在 mandatory=False 且没有其他路由机制介入时,生产者不会通过返回事件得到这次路由失败。
常见的不可路由原因
最常见的问题是 Routing Key 与 Binding 不一致,例如代码发布 order.cancelled,实际只绑定了 order.created。Topic Exchange 还可能因为通配模式写错而没有匹配项;Fanout Exchange 不检查 Routing Key,但如果它没有绑定任何队列,同样没有队列可以接收消息。
Exchange 类型也必须与预期路由规则一致。把原本按精确 Routing Key 设计的拓扑改成其他交换机类型,或者只声明了队列却忘记建立 Binding,都可能产生“程序发布正常、队列始终为空”的现象。
排查时按路由链逐段确认
遇到生产者日志显示发布完成、消费者却收不到消息时,不要直接从消费者代码开始猜。先确认发布使用的 Exchange 名称确实存在,再核对 Exchange 类型、Routing Key、Binding Key 和目标 Queue 是否一致,最后检查消息是否已经进入队列。
如果目标 Exchange 本身不存在,重点处理声明顺序、名称和虚拟主机配置;如果 Exchange 存在但没有匹配 Binding,则需要修正拓扑或启用 mandatory 感知路由失败。只有把“消息有没有到交换机”和“交换机有没有把消息送进队列”分开验证,才能准确判断消息消失在哪一段。