消息队列 / 系统课时

Topic Exchange 怎样匹配模式

Topic Exchange 怎样匹配模式

Topic Exchange 解决的是“一个 Routing Key 同时满足多种订阅模式”的问题。掌握点分词段、* 与 # 的匹配边界后,就能设计既灵活又可预测的主题路由,而不是靠试错调整 Binding。

学习目标

  • 理解 Topic Exchange 如何按点分隔的词段匹配 Routing Key
  • 区分 * 与 # 的匹配范围和边界
  • 能用实际消息验证不同 Binding Pattern 的路由结果

匹配规则先看词段

Topic Exchange 会把发布消息的 Routing Key 和绑定时的 Binding Key 作为点分隔的词段序列进行比较。例如 order.eu.created 有三个词段:order、eu、created。普通词段必须完全相同,通配符只在 Binding Key 中承担特殊含义。

* 只匹配恰好一个词段。因此 order.*.created 能匹配 order.eu.created,但不能匹配 order.created,也不能匹配 order.eu.vip.created。

# 匹配零个或多个词段。因此 order.# 既能匹配 order.created,也能匹配 order.eu.vip.created;只有 # 的 Binding 则可以匹配任意 Routing Key。

Topic Exchange 中星号与井号的主题匹配关系

用几组 Routing Key 判断边界

下面几组结果最适合用来检查自己是否把通配符理解成了正则表达式。Topic Exchange 的通配单位是“词段”,不是任意字符。

Binding Key Routing Key 是否匹配 原因
order.*.created order.eu.created 是 * 替代一个词段
order.*.created order.created 否 中间缺少一个词段
order.# order.created 是 # 可以匹配一个后续词段
order.# order.eu.vip.created 是 # 可以匹配多个后续词段
order.# order 是 # 也可以匹配零个词段

运行一个最小验证

下面的 Python 示例假设 RabbitMQ 运行在本机默认端口,并已安装 pika。脚本创建一个 Topic Exchange、两个临时队列和两条 Binding,再发布三条不同 Routing Key 的消息。

python
import pika

connection = pika.BlockingConnection(
    pika.ConnectionParameters(host="localhost")
)
channel = connection.channel()

exchange = "demo.topic.lesson"
channel.exchange_declare(
    exchange=exchange,
    exchange_type="topic",
    auto_delete=True,
)

one_segment_queue = channel.queue_declare(
    queue="", exclusive=True
).method.queue
many_segments_queue = channel.queue_declare(
    queue="", exclusive=True
).method.queue

channel.queue_bind(
    exchange=exchange,
    queue=one_segment_queue,
    routing_key="order.*.created",
)
channel.queue_bind(
    exchange=exchange,
    queue=many_segments_queue,
    routing_key="order.#",
)

for key in [
    "order.eu.created",
    "order.created",
    "order.eu.vip.created",
]:
    channel.basic_publish(
        exchange=exchange,
        routing_key=key,
        body=key.encode("utf-8"),
    )

def drain(queue_name):
    messages = []
    while True:
        method, _, body = channel.basic_get(
            queue=queue_name,
            auto_ack=True,
        )
        if method is None:
            break
        messages.append(body.decode("utf-8"))
    return messages

print("one-segment:", drain(one_segment_queue))
print("zero-or-more:", drain(many_segments_queue))

connection.close()

预期输出

text
one-segment: ['order.eu.created']
zero-or-more: ['order.eu.created', 'order.created', 'order.eu.vip.created']

这组输出说明 order.*.created 只接受中间恰好一个词段的消息,而 order.# 会覆盖更宽的层级。若实际环境中的主机名、端口或凭据不同,需要相应调整连接参数。

设计 Routing Key 时保持层级稳定

Topic Exchange 的价值来自“稳定层级 + 可变词段”。例如可以约定 业务.区域.事件,让消费者订阅 order.*.created 或 order.#。如果今天把区域放第二段、明天又把租户放第二段,同一条 Binding 很快就会变得难以维护。

当路由只需要完全相等时,Direct Exchange 更直接;当订阅规则确实需要按层级扩展、按一个词段或多个词段聚合时,再使用 Topic Exchange,通常更容易读懂和排查。

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

目录与阅读设置

阅读设置

17

记录一个想法

Topic Exchange 怎样匹配模式

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

登录哪都通