消息队列 / 系统课时
Direct 精确路由
Direct 精确路由
Direct 交换机适合把有限、明确的事件键映射到指定队列。本篇通过两个队列和两类订单事件验证精确匹配规则,并说明如何设计稳定的路由键,避免把 Direct 误当成只能“一条消息投一个队列”的单播机制。
学习目标
- 掌握 Direct 交换机“完整字符串相等”的匹配规则。
- 为同一交换机设计可维护的业务事件路由键。
- 验证一个路由键匹配多个队列、一个队列绑定多个路由键的行为。
Direct 只做精确相等匹配
Direct 交换机会比较“发布时的 routing_key”和“绑定上的 binding key”。两者完全相等才匹配,不支持 *、# 这类通配语义,也不会按前缀、后缀或大小写近似匹配。
Direct 并不等于单播。若 billing.q 和 audit.q 都绑定 order.paid,一条 order.paid 消息会分别进入两个队列;反过来,一个 audit.q 也可以同时绑定 order.created 与 order.paid。

用业务事件设计路由键
Direct 更适合路由键集合相对稳定、语义离散的场景,例如 order.created、order.paid、order.cancelled。这些键描述“事件类别”,消费者可以按职责绑定自己关心的类别,拓扑也容易从管理界面或监控指标中读懂。
不建议把订单号、用户 ID 等高基数值直接设计成 binding key。那会迫使系统维护大量动态绑定,增加拓扑管理成本。需要前缀或层级通配时,应优先考虑 Topic;完全不关心路由键、只要求所有绑定队列都收到消息时,则 Fanout 更直接。
构建两个队列的精确路由
下面示例创建 orders.direct,让 billing.q 只接收已支付事件,让 audit.q 同时接收创建和支付事件。示例会先清空测试队列,再发布两条消息,最后逐队列读取并打印结果。
import json
import os
import pika
HOST = os.getenv("RABBITMQ_HOST", "127.0.0.1")
PORT = int(os.getenv("RABBITMQ_PORT", "5672"))
EXCHANGE = "orders.direct"
BINDINGS = {
"billing.q": ["order.paid"],
"audit.q": ["order.created", "order.paid"],
}
credentials = pika.PlainCredentials(
os.getenv("RABBITMQ_USER", "guest"),
os.getenv("RABBITMQ_PASSWORD", "guest"),
)
connection = pika.BlockingConnection(
pika.ConnectionParameters(host=HOST, port=PORT, credentials=credentials)
)
channel = connection.channel()
channel.exchange_declare(exchange=EXCHANGE, exchange_type="direct", durable=False)
# 同一队列可以绑定多个精确键,同一精确键也可以绑定到多个队列。
for queue, keys in BINDINGS.items():
channel.queue_declare(queue=queue, durable=False)
channel.queue_purge(queue=queue)
for key in keys:
channel.queue_bind(queue=queue, exchange=EXCHANGE, routing_key=key)
events = [
("order.created", {"orderId": "order-1001"}),
("order.paid", {"orderId": "order-1001"}),
]
for routing_key, payload in events:
channel.basic_publish(
exchange=EXCHANGE,
routing_key=routing_key,
body=json.dumps(payload).encode("utf-8"),
)
def drain(queue):
messages = []
while True:
method, _, body = channel.basic_get(queue=queue, auto_ack=True)
if method is None:
return messages
messages.append(f"{method.routing_key}:{body.decode('utf-8')}")
for queue in BINDINGS:
print(f"{queue} => {drain(queue)}")
for queue in BINDINGS:
channel.queue_delete(queue=queue)
channel.exchange_delete(exchange=EXCHANGE)
connection.close()预期输出
billing.q => ['order.paid:{"orderId": "order-1001"}']
audit.q => ['order.created:{"orderId": "order-1001"}', 'order.paid:{"orderId": "order-1001"}']结果说明 order.paid 可以同时匹配两个队列,而 order.created 只匹配 audit.q。Direct 的“精确”描述的是键的比较方式,不是目标队列的数量。
选择 Direct 的边界
当路由条件可以枚举成一组稳定的完整键,并且消费者只需要“是否等于某个键”的判断时,Direct 往往最清晰。若开始出现“所有 order.* 都要接收”或“匹配 *.failed”这样的需求,就已经进入 Topic 的模式匹配范围。
把路由键控制在稳定的业务事件词汇表内,Direct 就能提供非常直观的投递边界:交换机负责精确比较,绑定表达订阅关系,队列承接匹配后的消息。