消息队列 / 知识点

RabbitMQ 开发与排障手册

手册条目

使用 routing key 或 headers 参数建立交换机到队列的绑定。

绑定队列

在交换机与已存在的队列之间建立绑定,用于定义消息从交换机进入队列的匹配条件。direct、topic 通常使用 routing key;headers 使用绑定参数;fanout 会忽略 routing key。

交换机到队列的绑定匹配关系

前置条件

交换机、队列必须位于同一个 vhost 且已存在。通过 Management HTTP API 操作时需启用 rabbitmq_management,账号需要访问该 vhost;创建绑定还要求对目标队列具备写权限、对源交换机具备读权限。

基本语法

HTTP API 使用 POST /api/bindings/{vhost}/e/{exchange}/q/{queue}。请求体中的 routing_key 和 arguments 均可选;路径里的 vhost、交换机名和队列名必须进行 URL 编码,默认 vhost / 写成 %2F。

高频用法

下面分别创建 topic routing key 绑定和 headers 参数绑定。示例假定 vhost 为 events,相关交换机与队列已经声明;密码使用环境变量传入,避免直接进入 Shell 历史。

bash
export RMQ_API='http://127.0.0.1:15672'
export RMQ_USER='ops'
export RMQ_PASS='<PASSWORD>'

# topic 绑定:消息 routing key 命中 events.order.* 时进入 target.queue
curl -sS -o /dev/null -w 'topic binding: %{http_code}\n' \
  -u "$RMQ_USER:$RMQ_PASS" \
  -H 'Content-Type: application/json' \
  -X POST \
  --data '{"routing_key":"events.order.*","arguments":{}}' \
  "$RMQ_API/api/bindings/events/e/events.topic/q/target.queue"

# headers 绑定:消息头同时满足 format=pdf 与 priority=high
curl -sS -o /dev/null -w 'headers binding: %{http_code}\n' \
  -u "$RMQ_USER:$RMQ_PASS" \
  -H 'Content-Type: application/json' \
  -X POST \
  --data '{"routing_key":"","arguments":{"x-match":"all","format":"pdf","priority":"high"}}' \
  "$RMQ_API/api/bindings/events/e/events.headers/q/priority.queue"

预期输出

text
topic binding: 201
headers binding: 201

201 表示绑定已创建。重复提交完全相同的源、目标、routing key 和参数不会产生新的路由效果;参数不同则可能形成另一条绑定。

验证绑定

按 vhost 查询绑定并只提取关键字段,避免在大型集群中拉取所有 vhost 的完整拓扑。

bash
curl -sS -u "$RMQ_USER:$RMQ_PASS" \
  "$RMQ_API/api/bindings/events" |
jq '[.[] |
  select(.source == "events.topic" or .source == "events.headers") |
  {
    source,
    destination,
    routing_key,
    x_match: (.arguments["x-match"] // null)
  }]'

预期输出

json
[
  {
    "source": "events.topic",
    "destination": "target.queue",
    "routing_key": "events.order.*",
    "x_match": null
  },
  {
    "source": "events.headers",
    "destination": "priority.queue",
    "routing_key": "",
    "x_match": "all"
  }
]

读取时先核对 source 和 destination,再看 routing_key 或 x_match。headers 交换机不依赖 routing key;x-match=all 要求列出的全部头匹配,any 则任意一个匹配即可。

风险与边界

绑定到错误 vhost、交换机或队列时,命令可能成功但业务消息进入错误路径。生产变更前先查询目标对象并记录现有绑定,优先在测试 vhost 验证,再用同一组名称和参数发布。

headers 匹配对字段名、值及 AMQP 数据类型敏感,例如字符串 "9" 与整数 9 不是同一值。安全做法是固定生产者的消息头类型,并用一条带 mandatory 或发布确认的测试消息验证路由。

删除绑定时若只凭 routing key 猜测,可能误删同一交换机与队列之间的其他参数化绑定。应先从绑定列表取得 properties_key,确认源、目标、routing key 和 arguments 后再调用对应 DELETE 接口。

默认交换机会在队列声明时自动按“队列名作为 routing key”创建绑定,不应把它当作普通业务交换机重复配置。

目录与阅读设置

记录一个想法

RabbitMQ 开发与排障手册

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

登录哪都通