消息队列 / 系统课时
业务路由拓扑设计
业务路由拓扑设计
业务路由设计的目标不是把所有事件都塞进一个交换机,而是让事件归属、订阅关系和故障边界一眼可见。本篇以订单、库存和通知三个域为例,设计 Exchange、Queue、Binding Key 与命名规范,并用代码验证拓扑能按预期路由。
学习目标
- 能按业务域划分 Exchange,并为事件设计稳定的 Routing Key
- 能让 Queue 归属到消费者,避免不同消费目的互相干扰
- 能用声明代码验证订单、库存和通知事件的订阅关系
先确定事件归属与消费关系
建议由“事件发生在哪个业务域”决定 Exchange,而不是由“谁要消费”决定 Exchange。订单服务发布订单事实,库存服务发布库存事实,通知服务发布通知结果;消费者通过自己的 Queue 和 Binding Key 订阅需要的事件。

这种划分让生产者只表达事实,不知道最终有多少消费者。新增审计、搜索或风控订阅时,只需声明新的 Queue 与 Binding,不必改动订单服务的发布逻辑。
建立可读的命名规范
Exchange 可以使用 evt.<domain>,例如 evt.order;Routing Key 使用 <domain>.<event>,例如 order.created;Queue 使用 q.<consumer>.<source-domain>,例如 q.inventory.order。名字直接暴露所有权和来源,排查积压时更容易定位责任边界。
事件名优先使用已经发生的事实,例如 order.paid、inventory.shortage,不要使用 send-email 这类面向某个消费者的命令式名称。否则生产者会逐渐知道下游实现,失去解耦价值。
声明一组最小业务拓扑
下面脚本创建三个 Topic Exchange、四个消费者队列和对应 Binding,并发布一条 order.created 事件验证库存队列能够收到消息。运行前需要本机 RabbitMQ 已启动并安装 pika。
import json
import pika
connection = pika.BlockingConnection(pika.ConnectionParameters("localhost"))
channel = connection.channel()
for exchange in ("evt.order", "evt.inventory", "evt.notification"):
channel.exchange_declare(exchange=exchange, exchange_type="topic", durable=True)
bindings = {
"q.inventory.order": [
("evt.order", "order.created"),
("evt.order", "order.cancelled"),
],
"q.notification.order": [
("evt.order", "order.paid"),
("evt.order", "order.cancelled"),
],
"q.order.inventory": [
("evt.inventory", "inventory.reserved"),
("evt.inventory", "inventory.shortage"),
],
"q.audit.notification": [
("evt.notification", "notification.#"),
],
}
for queue, rules in bindings.items():
channel.queue_declare(queue=queue, durable=True)
for exchange, binding_key in rules:
channel.queue_bind(queue=queue, exchange=exchange, routing_key=binding_key)
test_queue = "q.inventory.order"
channel.queue_purge(queue=test_queue)
event = {"orderId": "O-1001", "status": "CREATED"}
channel.basic_publish(
exchange="evt.order",
routing_key="order.created",
body=json.dumps(event).encode("utf-8"),
properties=pika.BasicProperties(
content_type="application/json",
delivery_mode=2,
type="order.created",
),
)
method, properties, body = channel.basic_get(queue=test_queue, auto_ack=True)
print("routing_key:", method.routing_key)
print("body:", body.decode("utf-8"))
connection.close()预期输出
routing_key: order.created
body: {"orderId": "O-1001", "status": "CREATED"}示例中的订单 ID 是固定测试值;真实系统中的 ID、时间戳和追踪标识应由业务请求生成,实际值会不同。
把故障边界放在队列上
Queue 应由消费方拥有。库存处理和通知发送即使都订阅 order.cancelled,也应该使用不同队列,因为它们的吞吐、重试、积压和故障处理完全不同。RabbitMQ 会把同一事件复制到两个队列,使两个业务动作彼此独立。
为生产环境继续扩展时,可以在每个消费队列旁增加对应的死信队列,并保持同样的所有权命名,例如 q.inventory.order.dlq。重试与死信策略属于消费方治理,不应反向污染生产者的 Routing Key。
用变更场景检验拓扑是否稳固
设计完成后,可以用三个问题做验收:新增消费者是否只需要加 Queue 和 Binding;某个消费者积压时是否不会拖慢其他消费者;事件名称是否仍然描述业务事实而不是下游动作。如果三个答案都是“是”,这套拓扑通常具备较好的扩展性。
订单、库存和通知只是示例域。真正决定拓扑质量的不是 Exchange 数量,而是事件所有权清晰、Queue 边界独立、Routing Key 稳定,并且每个订阅关系都能从命名和 Binding 中直接读出来。