一条订单消息要同时交给通知服务和分析服务,应该建一个队列还是两个?给一个队列增加两个消费者,又会发生什么?
RabbitMQ 的交换机、绑定和队列,正是用来表达这些关系的。这一篇先解释消息如何路由,再用管理界面做一个不依赖 Java 的小实验。
本文讨论 RabbitMQ 的 AMQP 0-9-1 队列模型。练习固定使用 RabbitMQ 4.1.0;这个版本用于复现示例,不代表生产环境的版本推荐。
1. 沿着一条消息认识各个角色
先看完整路径:
生产者 → Exchange(交换机) → 根据 Routing Key 与 Binding 匹配 → Queue(队列) → Consumer(消费者)生产者提交消息时,指定交换机和路由键。交换机根据已有绑定,把消息送到零个、一个或多个队列;消费者订阅队列并接收投递。
| 名称 | 在这个过程中负责什么 |
|---|---|
| Producer | 发布订单事件 |
| Exchange | 判断消息该进入哪些队列 |
| Routing Key | 随消息携带的路由标签 |
| Binding | 队列与交换机之间的匹配规则 |
| Queue | 保留待消费和未确认的消息 |
| Consumer | 处理收到的消息 |
| Broker | 运行这些资源的 RabbitMQ 服务 |
路由键是发布时携带的值,绑定键是配置在绑定上的规则。对于 direct,它们做精确匹配;对于 topic,绑定键可以包含通配符。
还有两个词很快会遇到:vhost 是交换机、队列等资源的逻辑命名空间;channel 是连接上的协议通道。第三篇中的应用必须连接到声明资源时使用的同一个 vhost。
“直接发送到队列”是怎么回事
RabbitMQ 有一个名称为空字符串的默认交换机,队列声明后会自动按队列名与它绑定。因此,一些 API 看起来只需要队列名,实际仍然经过默认交换机。
这与普通的业务交换机不同:自己新建的交换机,不会自动知道该把消息送到哪个队列。来源:Exchanges
2. 一个队列的多个消费者,是分工
假设只有一个通知队列:
order.sms → 通知实例 A → 通知实例 B两个实例竞争处理队列中的消息。一条投递通常只交给其中一个实例,不是每个实例都收到一份;处理失败或确认丢失时,仍可能再次投递。
这适合给同一种工作增加处理能力。把通知消费者和分析消费者都放进同一个队列,则会让两种业务抢消息:有些订单只通知,有些订单只分析。
若两种业务都必须知道订单创建,就应该分成两个队列:
订单交换机 → order.sms → 通知实例 A / B → order.audit → 分析实例 A / B不同消费目的分队列,同一消费目的可增加消费者实例。这是比选择交换机类型更早需要确定的设计。队列的 FIFO 行为也不意味着多个消费者的业务完成顺序相同。队列与消费者行为
3. Direct:按完整的键精确匹配
假设有以下绑定:
sms 队列 ← order.createdaudit 队列 ← order.createdrefund 队列 ← order.refunded发布 order.created 时,sms 和 audit 都收到消息。Direct 的“精确”指匹配方式,并不意味着只能匹配一个队列。
如果发布 order.paid,而没有对应绑定,消息就不会进入这三个队列。它也不会留在交换机里等待将来建立绑定。
对于少量且明确的业务事件,direct 足够清楚,不必为了“以后可能扩展”提前使用通配符。
4. Fanout:忽略路由键,交给所有绑定队列
Fanout 把消息发给当时绑定的每个队列,不依据 routing key 筛选。
活动广播交换机 → 通知队列 → 分析队列 → 搜索更新队列这种方式适合“绑定这个交换机,就关心这里的所有消息”的订阅关系。它广播的是队列,不是队列中的每一个消费者实例。
如果不同订阅者只关心部分事件,fanout 会把筛选工作推到消费者;这时可以考虑 direct 或 topic。
5. Topic:按点分隔的片段匹配
Topic 将路由键按 . 分成若干片段:
*匹配恰好一个片段。#匹配零个或多个片段。
用一组容易混淆的例子检查理解:
| 绑定键 | 匹配示例 |
|---|---|
| order.* | order.created |
| order.# | order、order.created、 order.created.vip |
| *.created | order.created、refund.created |
order.* 不匹配单独的 order,也不匹配 order.created.vip。order.# 可以匹配单独的 order,因为 # 允许零个片段。
它不是任意字符串前缀匹配:order.# 不会匹配 orders.created。把词边界想清楚,比背“星号一个、井号多个”更重要。
本系列用 topic 演示两个订阅范围:通知只关心 order.created,分析关心 order.#。这只是案例选择,不是所有系统都应优先用 topic。三种交换机的官方说明
6. 启动一个独立的本地练习环境
可以下载 完整练习包,其中包含同样的 compose.yaml。本节暂时只启动 Broker,第三篇再启动 Java 应用。
name: mq-blog-demoservices: rabbitmq: image: rabbitmq:4.1.0-management hostname: mq-demo environment: RABBITMQ_DEFAULT_USER: mq_demo RABBITMQ_DEFAULT_PASS: local-demo-only RABBITMQ_DEFAULT_VHOST: mq-demo ports: - "127.0.0.1:5673:5672" - "127.0.0.1:15673:15672" volumes: - rabbit-data:/var/lib/rabbitmq healthcheck: test: ["CMD", "rabbitmq-diagnostics", "-q", "ping"] interval: 10s timeout: 5s retries: 12volumes: rabbit-data:这些账号信息仅用于本机练习,端口只绑定本机地址。应用连接端口是 5673,浏览器管理端口是 15673,不要把它们用反。
在文件所在目录执行:
docker compose up -ddocker compose ps等待容器状态为 healthy,再打开 本地管理界面,使用 mq_demo / local-demo-only 登录,操作时选择 mq-demo vhost。
数据卷会保留 Broker 数据。已有数据卷时,修改环境变量不会自动重建账户和 vhost;如果遇到登录问题,先核对当前环境,而不是反复修改 Java 密码。RabbitMQ 容器说明
7. 做一次路由实验,亲眼看到两份消息
本节资源都使用 lab. 前缀,与第三篇程序创建的 demo. 资源分开,避免手工声明参数与代码声明冲突。
在管理界面依次完成:
- 在 Exchanges 新建
lab.order.events,类型选topic,Durable 选 Yes。 - 在 Queues and Streams 新建
lab.order.sms和lab.order.audit,使用 Classic、Durable 队列,其他参数保持默认。 - 打开交换机详情,在 Bindings 中把
lab.order.sms绑定到order.created。 - 再把
lab.order.audit绑定到order.#。
现在还没有消费者,所以发布成功后消息会留在队列中,便于观察。
在交换机详情的 Publish message 中填写:
Routing key: order.createdProperties: {"content_type":"application/json","delivery_mode":2}Payload: {"orderId":10001,"eventType":"ORDER_CREATED"}Properties 表示需要添加的两个 AMQP 属性;按管理界面的字段输入,不要把它们混进 Payload。
发布一次后,两个队列的 Ready 都应增加 1。再分别发布下列路由键,每次都观察计数的变化:
| Routing key | Ready 增量 |
|---|---|
| order.created | sms +1,audit +1 |
| order.paid | sms +0,audit +1 |
| refund.created | 两者都不增加 |
这些是预期结果,不是本文环境中的实测截图。若看到的结果不同,先检查 vhost、交换机名、队列绑定和路由键,而不是直接重启服务。
管理界面的 Get messages 也会实际获取消息,并不是只读预览。想保留练习消息时,选择带 requeue 的方式;不重新入队的获取可能使消息离开队列。
8. 路由成功之后,还要等消费确认
在没有消费者时,消息通常显示为 Ready。消费者收到消息但尚未确认时,会显示为 Unacked;确认完成后,它不再占用该队列的待处理数量。
Ready → 投递给消费者 → Unacked → 确认后移除 | └→ 连接中断等情况可能重新投递要特别区分两套名称相似的模式:
| 名称 | 确认行为 |
|---|---|
| RabbitMQ auto-ack | 投递后不等待业务确认 |
| Spring NONE | 使用协议层自动确认 |
| Spring AUTO | 监听方法正常完成后 由容器确认 |
| Spring MANUAL | 应用代码决定何时 ack |
Spring 的 AUTO 不等于 RabbitMQ 的 auto-ack。在普通同步监听方法中,让业务异常正常抛出,容器才能知道本次处理失败;把异常捕获后直接返回,会使容器将它视作成功。
因此,不能笼统地说“默认确认都不可靠,必须手动 ack”。第三篇使用 Spring AUTO,先把成功和失败行为讲清楚。Spring AMQP 容器确认模式
发布端也有自己的确认,但它不等待消费者执行业务。对无法路由的消息,要结合 mandatory 返回机制判断;仅看 publisher confirm 的 ack,并不能说明消息进入了业务队列。
9. 失败消息为什么需要另一个出口
如果业务失败后立即重新入队,消费者可能马上又收到同一条消息:
取消息 → 固定报错 → 重新入队 → 再取消息 → 再报错这不是有间隔、有上限的重试策略,而是可能持续占用资源的循环。
一种入门处理方式是:失败时拒绝且不重新入队,让消息经 死信交换机(DLX) 路由到专门的失败队列。
DLX 本身仍是交换机,失败队列仍是普通队列,必须配置对应绑定。只有“拒绝”而没有配置 DLX,并不会自动帮你保存失败消息。
此外,死信转发的可靠性也取决于队列类型和配置。普通死信转发不能被当成绝不丢失的保证;本文的单节点练习主要用于观察失败路径。来源:Dead Letter Exchanges
10. 持久化、监控与排错,各看什么
持久化要分清“结构”和“消息”:durable 交换机与队列用于恢复拓扑,消息的 persistent 属性用于请求持久保存。还需要配合发布确认、磁盘与节点故障策略,不能只设置 durable 就宣称可靠交付。
排查时,沿着消息路径看,比凭感觉修改配置有效:
| 现象 | 先检查 |
|---|---|
| 两个队列都没收到 | vhost、交换机、路由键、绑定 |
| Ready 持续增加 | 消费者是否在线,处理是否够快 |
| Unacked 长期不降 | 业务是否阻塞,确认是否发出 |
| 消息反复投递 | 业务异常、连接变化、重入队设置 |
| 死信不断增长 | 错误原因与处置任务是否明确 |
Ready 为零本身不能证明业务成功:消息也可能正在处理、被拒绝、已过期,甚至从未进入队列。需要结合发布结果、消费者日志和业务数据一起判断。
下一篇会把这些配置写进 Spring Boot 工程,观察一条消息从 HTTP 请求到两个消费者,再到失败队列的完整过程。
上一篇:为什么需要消息队列
下一篇:Spring Boot 集成 RabbitMQ
If this article helped you, please share it with others!
Some information may be outdated






