消息队列 / 系统课时

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 交换机精确路由关系

用业务事件设计路由键

Direct 更适合路由键集合相对稳定、语义离散的场景,例如 order.created、order.paid、order.cancelled。这些键描述“事件类别”,消费者可以按职责绑定自己关心的类别,拓扑也容易从管理界面或监控指标中读懂。

不建议把订单号、用户 ID 等高基数值直接设计成 binding key。那会迫使系统维护大量动态绑定,增加拓扑管理成本。需要前缀或层级通配时,应优先考虑 Topic;完全不关心路由键、只要求所有绑定队列都收到消息时,则 Fanout 更直接。

构建两个队列的精确路由

下面示例创建 orders.direct,让 billing.q 只接收已支付事件,让 audit.q 同时接收创建和支付事件。示例会先清空测试队列,再发布两条消息,最后逐队列读取并打印结果。

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

预期输出

text
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 就能提供非常直观的投递边界:交换机负责精确比较,绑定表达订阅关系,队列承接匹配后的消息。

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

目录与阅读设置

阅读设置

17

记录一个想法

Direct 精确路由

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

登录哪都通