消息队列 / 系统课时

为订单消息加入可靠发布

为订单消息加入可靠发布

仅仅调用 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。

python
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 时,预期输出:

text
publish confirmed: order-1001

如果故意把 routing_key 改成没有任何 Binding 的值,例如 order.unknown,在 Confirm 模式下配合 mandatory=True 会进入失败处理;异常类型由客户端库和具体失败原因决定,因此不要依赖固定错误文本,业务代码应依赖“成功或失败”这一状态。

可靠发布不等于业务完成

Publisher Confirm 的确认边界到 RabbitMQ 为止。Broker 返回 ACK,只表示它接受并处理了这次发布,不表示库存服务已经消费,更不表示库存扣减成功。消费者侧仍需独立处理手动 ACK、幂等和失败重试。

可靠发布的判断顺序可以简化为:先保证拓扑和消息可持久化,再让不可路由失败可见,最后用 Confirm 判断 Broker 是否确认;任何失败都必须留下可追踪的订单事件,才能支持后续重试和补偿。

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

目录与阅读设置

阅读设置

17

记录一个想法

为订单消息加入可靠发布

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

登录哪都通