消息队列 / 系统课时

Topic 模式匹配

Topic 模式匹配

Topic 交换机用于按“分段的 routing key”做模式路由。它比 Direct 更灵活:绑定可以精确匹配固定单词,也可以用 * 和 # 覆盖一组 routing key,从而让生产者保持稳定的事件命名,让不同队列自行声明订阅范围。

学习目标

  • 掌握 Topic routing key 的分段规则以及 *、# 的含义
  • 能根据绑定模式判断一条消息会进入哪些队列
  • 能用可运行示例验证精确、单段通配和多段通配的差异

Topic 的匹配规则

Topic 的 routing key 通常由点号分隔成多个单词,例如 order.created、order.eu.created。绑定键按相同方式分段,其中 * 只匹配恰好一个单词,# 匹配零个或多个单词,普通单词则要求对应位置完全一致。

routing key order.* order.# *.created
order.created 匹配 匹配 匹配
order.eu.created 不匹配 匹配 不匹配
payment.created 不匹配 不匹配 匹配
order 不匹配 匹配 不匹配

这不是正则表达式:* 不会跨过点号,# 才能跨越多个分段。交换机会独立检查每条绑定,因此同一消息可能同时进入多个不同队列。

最小可运行验证

下面示例创建三个临时队列,分别绑定 order.*、order.# 和 *.created,再发布三条不同 routing key 的消息,最后逐队列读取实际结果。

python
import pika

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

exchange = 'demo.topic'
channel.exchange_declare(
    exchange=exchange,
    exchange_type='topic',
    durable=False
)

bindings = [
    ('q-order-one-word', 'order.*'),
    ('q-order-all', 'order.#'),
    ('q-created', '*.created'),
]

queues = []
for label, pattern in bindings:
    result = channel.queue_declare(
        queue='',
        exclusive=True,
        auto_delete=True
    )
    queue_name = result.method.queue
    channel.queue_bind(
        exchange=exchange,
        queue=queue_name,
        routing_key=pattern
    )
    queues.append((label, queue_name))

for routing_key in [
    'order.created',
    'order.eu.created',
    'payment.created',
]:
    channel.basic_publish(
        exchange=exchange,
        routing_key=routing_key,
        body=routing_key.encode()
    )

for label, queue_name in queues:
    while True:
        method, _, body = channel.basic_get(
            queue=queue_name,
            auto_ack=True
        )
        if method is None:
            break
        print(f'{label}: {body.decode()}')

connection.close()

预期输出

text
q-order-one-word: order.created
q-order-all: order.created
q-order-all: order.eu.created
q-created: order.created
q-created: payment.created

输出与匹配表一一对应:order.* 只能接住两段且第一段为 order 的键;order.# 可以接住 order 后面任意深度的层级;*.created 要求恰好两段并以 created 结尾。

设计可维护的 routing key

routing key 最好表达稳定的业务分类,而不是临时实现细节。常见做法是从较稳定的大类向具体动作展开,例如 order.created、order.cancelled、payment.failed;如果还需要地区或租户维度,可以增加分段,但要保持各位置语义一致。

绑定应尽量从窄到宽设计。订阅所有订单事件可用 order.#,只订阅订单的一层动作可用 order.*,只关心所有领域的创建事件可用 *.created。如果直接使用 #,几乎等价于接收该 Topic 交换机上的所有 routing key,后续新增事件也会自动进入该队列。

容易写错的边界

order.* 不匹配 order.eu.created,因为 * 只能占一个分段;order.# 则可以匹配 order、order.created 和更深层的 order.eu.created。同样,*.created 不能匹配三段键,即使最后一段仍然是 created。

Topic 的核心是把“谁需要什么消息”放在绑定模式中表达。只要 routing key 的分段语义稳定,生产者无需知道订阅者数量,消费者也能通过调整绑定独立扩大或收窄自己的订阅范围。

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

目录与阅读设置

阅读设置

17

记录一个想法

Topic 模式匹配

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

登录哪都通