消息队列 / 系统课时

mandatory 怎样发现路由失败

mandatory 怎样发现路由失败

默认发布模式下,交换机存在但找不到任何匹配队列时,生产者可能看不到明显异常。mandatory 标志让这种结果变得可观察:无法路由的消息会通过 Basic.Return 返回生产者,从而可以记录、告警或进入补偿流程。

学习目标

  • 理解 mandatory=true 改变的是不可路由消息的处理方式
  • 使用返回回调读取 Basic.Return 的原因、Exchange 和 Routing Key
  • 区分 mandatory、Publisher Confirm 与消费者确认各自解决的问题

mandatory 关注的是有没有匹配队列

生产者发布消息时设置 mandatory=true 后,RabbitMQ 会正常执行交换机路由。如果至少有一个队列能够接收消息,发布按正常路径继续;如果交换机存在却无法把消息路由到任何匹配队列,Broker 会向生产者发送 Basic.Return。

mandatory 发布时的成功与返回分支

这里的“返回”不是把消息重新投递到生产者自己的队列,而是 AMQP 协议层的返回事件。应用通常在回调中取得返回原因以及原消息内容,再决定记录日志、告警、重试还是转入业务补偿。

注册返回回调观察 NO_ROUTE

下面继续使用 Direct Exchange。队列只绑定 order.created,生产者却发布 order.cancelled,并把 mandatory 设置为 True。add_on_return_callback 用于处理 Broker 返回的不可路由消息。

python
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()

预期输出

text
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;需要确认业务消费完成,则由消费者确认机制负责。把三个阶段分别观测,才能避免把“发布过”“进入队列”和“已经处理成功”混成同一个状态。

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

目录与阅读设置

阅读设置

17

记录一个想法

mandatory 怎样发现路由失败

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

登录哪都通