消息队列 / 系统课时

Headers 属性路由

Headers 属性路由

Headers 交换机不依赖 routing key,而是把消息属性中的 headers 与队列绑定参数进行匹配。本篇用一个可运行示例演示 x-match=all 与 x-match=any 的差异,并说明什么时候值得用属性组合路由。

学习目标

  • 理解 Headers 交换机的匹配依据与消息流向
  • 能使用 x-match 设计“全部满足”或“任一满足”的绑定
  • 能识别 Headers 路由与 Topic 路由的适用边界

Headers 路由看什么

生产者仍然把消息发布到 Exchange,但 Headers 交换机会忽略 routing key,转而检查 BasicProperties.headers。每条 Binding 都可以声明一组键值条件,例如 format=pdf、priority=high,RabbitMQ 根据这些条件决定消息是否进入对应 Queue。

Headers 交换机按消息头组合匹配队列

x-match=all 表示除匹配控制参数外,绑定中列出的业务 header 都必须满足;x-match=any 表示任意一个条件满足即可。缺失某个必需 header 或值不相等时,all 绑定不会命中。

用可运行示例验证 all 与 any

下面脚本会创建一个 Headers Exchange 和两个队列,先清空测试队列,再发送两条消息。运行前需要本机 RabbitMQ 已启动,并安装 Python 包 pika。

python
import pika

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

exchange = "docs.headers"
strict_queue = "q.docs.strict"
flexible_queue = "q.docs.flexible"

channel.exchange_declare(exchange=exchange, exchange_type="headers", durable=True)

for queue in (strict_queue, flexible_queue):
    channel.queue_declare(queue=queue, durable=True)
    channel.queue_purge(queue=queue)

conditions = {"format": "pdf", "priority": "high"}
channel.queue_bind(
    queue=strict_queue,
    exchange=exchange,
    arguments={"x-match": "all", **conditions},
)
channel.queue_bind(
    queue=flexible_queue,
    exchange=exchange,
    arguments={"x-match": "any", **conditions},
)

channel.basic_publish(
    exchange=exchange,
    routing_key="ignored",
    body=b"match-one",
    properties=pika.BasicProperties(headers={"format": "pdf", "priority": "low"}),
)
channel.basic_publish(
    exchange=exchange,
    routing_key="ignored",
    body=b"match-both",
    properties=pika.BasicProperties(headers={"format": "pdf", "priority": "high"}),
)

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

print("strict:", drain(strict_queue))
print("flexible:", drain(flexible_queue))
connection.close()

预期输出

text
strict: ['match-both']
flexible: ['match-one', 'match-both']

实际运行时,如果目标队列中已有历史消息,输出会不同;示例通过 queue_purge 保证本次验证结果可重复。

设计消息头时避免隐式耦合

Headers 路由适合条件不是天然层级字符串的场景,例如“格式 + 优先级”“地区 + 客户等级”“协议版本 + 能力标记”。这些属性最好来自稳定的业务元数据,而不是临时拼出的技术字段。

如果条件可以自然表达成 order.created.eu、audit.# 这类层级模式,Topic Exchange 通常更直观;只有当“多个独立属性的组合”本身就是路由条件时,Headers Exchange 才更合适。

判断一条消息会不会命中

排查 Headers 路由时,按顺序核对 Exchange 类型、Binding arguments、消息 headers、x-match 模式。不要把 routing key 当成诊断重点,因为 Headers Exchange 不用它做匹配。

一个实用原则是:生产者只负责附带稳定属性,消费者通过自己的 Binding 声明订阅条件。这样新增消费者通常只需要增加队列和绑定,不需要修改已有生产者。

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

目录与阅读设置

阅读设置

17

记录一个想法

Headers 属性路由

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

登录哪都通