消息队列 / 系统课时
mandatory 怎样发现路由失败
mandatory 怎样发现路由失败
默认发布模式下,交换机存在但找不到任何匹配队列时,生产者可能看不到明显异常。mandatory 标志让这种结果变得可观察:无法路由的消息会通过 Basic.Return 返回生产者,从而可以记录、告警或进入补偿流程。
学习目标
- 理解
mandatory=true改变的是不可路由消息的处理方式 - 使用返回回调读取
Basic.Return的原因、Exchange 和 Routing Key - 区分 mandatory、Publisher Confirm 与消费者确认各自解决的问题
mandatory 关注的是有没有匹配队列
生产者发布消息时设置 mandatory=true 后,RabbitMQ 会正常执行交换机路由。如果至少有一个队列能够接收消息,发布按正常路径继续;如果交换机存在却无法把消息路由到任何匹配队列,Broker 会向生产者发送 Basic.Return。

这里的“返回”不是把消息重新投递到生产者自己的队列,而是 AMQP 协议层的返回事件。应用通常在回调中取得返回原因以及原消息内容,再决定记录日志、告警、重试还是转入业务补偿。
注册返回回调观察 NO_ROUTE
下面继续使用 Direct Exchange。队列只绑定 order.created,生产者却发布 order.cancelled,并把 mandatory 设置为 True。add_on_return_callback 用于处理 Broker 返回的不可路由消息。
import pika
def on_return(channel, method, properties, body):
print(
f"return: {method.reply_code} {method.reply_text} "
f"exchange={method.exchange} routing_key={method.routing_key}"
)
print("body:", body.decode("utf-8"))
connection = pika.BlockingConnection(
pika.ConnectionParameters(host="localhost")
)
channel = connection.channel()
exchange = "demo.mandatory.direct"
queue = "demo.mandatory.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.add_on_return_callback(on_return)
channel.basic_publish(
exchange=exchange,
routing_key="order.cancelled",
body=b"order-1001",
mandatory=True,
)
# BlockingConnection 需要继续处理网络事件,回调才能被分发。
connection.process_data_events(time_limit=1)
print("return event processed")
connection.close()预期输出
return: 312 NO_ROUTE exchange=demo.mandatory.direct routing_key=order.cancelled
body: order-1001
return event processed实际运行时,如果交换机、队列或绑定名称被修改,输出中的名称也会随之变化。312 NO_ROUTE 表示 Broker 找到了交换机,但没有找到可以接收该消息的路由目标。
返回事件里应该处理什么
生产环境的返回回调至少应记录 Exchange、Routing Key、业务消息标识和返回原因,这样才能从日志定位究竟是哪一条路由规则失效。对于不能丢失的业务消息,还需要明确补偿策略,例如写入持久化失败记录或交给上层业务重试,而不是只打印日志后继续运行。
也不要在回调里无限立即重发。同一个错误 Routing Key 如果没有修正,重新发布只会再次收到 NO_ROUTE,最终形成无意义的重试循环。重试前必须先判断失败是否具有可恢复性。
mandatory、Confirm 和消费者确认不是一回事
mandatory 观察的是路由结果:消息到达 Exchange 后,有没有队列能够接收。Publisher Confirm 观察的是生产者发布后 Broker 对这次发布的确认结果,而消费者的 Ack 或 Nack 则发生在消息已经进入队列并被消费者取得之后。
因此,可靠发布通常不能只依赖其中一个机制。需要发现错误 Routing Key 或缺失 Binding 时使用 mandatory;需要确认 Broker 对发布的处理结果时再结合 Publisher Confirm;需要确认业务消费完成,则由消费者确认机制负责。把三个阶段分别观测,才能避免把“发布过”“进入队列”和“已经处理成功”混成同一个状态。