消息队列 / 系统课时
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。

x-match=all 表示除匹配控制参数外,绑定中列出的业务 header 都必须满足;x-match=any 表示任意一个条件满足即可。缺失某个必需 header 或值不相等时,all 绑定不会命中。
用可运行示例验证 all 与 any
下面脚本会创建一个 Headers Exchange 和两个队列,先清空测试队列,再发送两条消息。运行前需要本机 RabbitMQ 已启动,并安装 Python 包 pika。
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()预期输出
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 声明订阅条件。这样新增消费者通常只需要增加队列和绑定,不需要修改已有生产者。