消息队列 / 系统课时
为订单消息加入可靠发布
为订单消息加入可靠发布
仅仅调用 basic_publish 并不代表订单事件已经可靠进入 RabbitMQ。可靠发布需要同时处理消息持久化、不可路由消息和 Publisher Confirm,并把确认失败的事件留下可追查记录,避免业务已经提交而消息悄悄丢失。
学习目标
- 能区分消息持久化、mandatory 路由检查和 Publisher Confirm 的职责
- 能为订单事件开启发布确认并识别不可路由或被 Broker 拒绝的情况
- 能把发布失败事件记录下来,作为后续重试或补偿的依据
三道保护各自解决什么问题
消息持久化要求 Exchange、Queue 为 durable,消息属性使用 delivery_mode=2,用于降低 Broker 重启后的消息丢失风险。它不负责告诉生产者“这次发布是否成功”。
mandatory=True 处理的是路由失败:Exchange 找不到任何匹配 Queue 时,生产者能够感知,而不是默认丢弃。Publisher Confirm 则让 Broker 对已处理的发布返回 ACK 或 NACK,生产者据此判断是否需要记录失败。

实现持久化与 Publisher Confirm
下面示例假设 RabbitMQ 在 localhost,并已安装 pika。脚本先声明持久化拓扑,再开启 Confirm;只要发生不可路由、NACK 或 AMQP 异常,就把订单事件以 JSON 行记录到 failed-order-events.log。
import json
from datetime import datetime, timezone
import pika
from pika.exceptions import AMQPError, NackError, UnroutableError
event = {
"eventId": "evt-1001",
"orderId": "order-1001",
"type": "order.created",
}
connection = None
try:
connection = pika.BlockingConnection(pika.ConnectionParameters("localhost"))
channel = connection.channel()
channel.exchange_declare(
exchange="order.events",
exchange_type="topic",
durable=True,
)
channel.queue_declare(queue="order.inventory.q", durable=True)
channel.queue_bind(
exchange="order.events",
queue="order.inventory.q",
routing_key="order.created",
)
# Confirm 判断 Broker 是否确认;mandatory 让不可路由消息变成可感知失败。
channel.confirm_delivery()
channel.basic_publish(
exchange="order.events",
routing_key="order.created",
body=json.dumps(event).encode(),
properties=pika.BasicProperties(
content_type="application/json",
delivery_mode=2,
),
mandatory=True,
)
print("publish confirmed:", event["orderId"])
except (UnroutableError, NackError, AMQPError) as exc:
failure = {
"recordedAt": datetime.now(timezone.utc).isoformat(),
"event": event,
"reason": type(exc).__name__,
}
with open("failed-order-events.log", "a", encoding="utf-8") as file:
file.write(json.dumps(failure, ensure_ascii=False) + "\n")
print("publish failed:", type(exc).__name__)
finally:
if connection is not None and connection.is_open:
connection.close()在拓扑正常且 Broker 返回 ACK 时,预期输出:
publish confirmed: order-1001如果故意把 routing_key 改成没有任何 Binding 的值,例如 order.unknown,在 Confirm 模式下配合 mandatory=True 会进入失败处理;异常类型由客户端库和具体失败原因决定,因此不要依赖固定错误文本,业务代码应依赖“成功或失败”这一状态。
可靠发布不等于业务完成
Publisher Confirm 的确认边界到 RabbitMQ 为止。Broker 返回 ACK,只表示它接受并处理了这次发布,不表示库存服务已经消费,更不表示库存扣减成功。消费者侧仍需独立处理手动 ACK、幂等和失败重试。
可靠发布的判断顺序可以简化为:先保证拓扑和消息可持久化,再让不可路由失败可见,最后用 Confirm 判断 Broker 是否确认;任何失败都必须留下可追踪的订单事件,才能支持后续重试和补偿。