消息队列 / 系统课时
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 的消息,最后逐队列读取实际结果。
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()预期输出
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 的分段语义稳定,生产者无需知道订阅者数量,消费者也能通过调整绑定独立扩大或收窄自己的订阅范围。