RabbitMQ Headers Exchange路由异常：消息发往所有队列而非匹配队列

你的理解有偏差，Headers交换机既支持检查header是否存在，也支持校验对应的值，问题出在绑定队列时的x-match参数配置或者绑定规则上。

核心逻辑说明 #

Headers交换机的路由完全依赖绑定队列时指定的参数，其中最关键的是x-match：

• 当x-match设为all：消息必须包含绑定中指定的所有header键，且每个键对应的值都完全匹配，才会被路由到该队列
• 当x-match设为any：消息只要包含绑定中指定的任意一个header键（如果绑定指定了值，对应的值也要匹配），就会被路由到该队列
• 如果绑定未显式设置x-match，多数客户端会默认使用any，这会导致只要消息的header和某个队列绑定的header有重叠，就会触发路由

你的场景排查方向 #

你预期消息仅发往event.retry.fail队列，但实际所有绑定队列都收到了，大概率是以下情况之一：

• event.retry.fail队列的绑定未设置x-match: all，或者其他队列的绑定用了x-match: any，且你的消息header包含这些队列绑定的某个键
• 其他队列的绑定仅指定了header键（未设值），而你的消息恰好包含这些键，此时只要x-match不是all就会触发路由
• 发送消息时的header设置有误，意外包含了其他队列绑定的键值对

正确配置示例 #

以常见的客户端配置为例，要让event.retry.fail队列仅接收符合特定键值对的消息，绑定配置应该类似这样：

# 伪代码，以Python pika客户端为例
bind_args = {
    'x-match': 'all',
    'event-type': 'fail',
    'retry': 'true'
}
channel.queue_bind(
    queue='event.retry.fail',
    exchange='your-headers-exchange',
    routing_key='',  # Headers交换机不需要routing key
    arguments=bind_args
)

这样只有当消息同时携带event-type: fail和retry: true两个header时，才会被路由到该队列。

内容的提问来源于stack exchange，提问作者RHarris