mobile wallpaper 1mobile wallpaper 2mobile wallpaper 3mobile wallpaper 4
2818 words
7 minutes
MQ 从 0 到 1(二):RabbitMQ 基础模型
2025-08-17
2026-09-28

一条订单消息要同时交给通知服务和分析服务,应该建一个队列还是两个?给一个队列增加两个消费者,又会发生什么?

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.created
audit 队列 ← order.created
refund 队列 ← 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
*.createdorder.created、refund.created

order.* 不匹配单独的 order,也不匹配 order.created.vip。order.# 可以匹配单独的 order,因为 # 允许零个片段。

它不是任意字符串前缀匹配:order.# 不会匹配 orders.created。把词边界想清楚,比背“星号一个、井号多个”更重要。

本系列用 topic 演示两个订阅范围:通知只关心 order.created,分析关心 order.#。这只是案例选择,不是所有系统都应优先用 topic。三种交换机的官方说明

6. 启动一个独立的本地练习环境#

可以下载 完整练习包,其中包含同样的 compose.yaml。本节暂时只启动 Broker,第三篇再启动 Java 应用。

compose.yaml
name: mq-blog-demo
services:
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: 12
volumes:
rabbit-data:

这些账号信息仅用于本机练习,端口只绑定本机地址。应用连接端口是 5673,浏览器管理端口是 15673,不要把它们用反。

在文件所在目录执行:

docker compose up -d
docker compose ps

等待容器状态为 healthy,再打开 本地管理界面,使用 mq_demo / local-demo-only 登录,操作时选择 mq-demo vhost。

数据卷会保留 Broker 数据。已有数据卷时,修改环境变量不会自动重建账户和 vhost;如果遇到登录问题,先核对当前环境,而不是反复修改 Java 密码。RabbitMQ 容器说明

7. 做一次路由实验,亲眼看到两份消息#

本节资源都使用 lab. 前缀,与第三篇程序创建的 demo. 资源分开,避免手工声明参数与代码声明冲突。

在管理界面依次完成:

  1. 在 Exchanges 新建 lab.order.events,类型选 topic,Durable 选 Yes。
  2. 在 Queues and Streams 新建 lab.order.sms 和 lab.order.audit,使用 Classic、Durable 队列,其他参数保持默认。
  3. 打开交换机详情,在 Bindings 中把 lab.order.sms 绑定到 order.created。
  4. 再把 lab.order.audit 绑定到 order.#。

现在还没有消费者,所以发布成功后消息会留在队列中,便于观察。

在交换机详情的 Publish message 中填写:

Routing key: order.created
Properties: {"content_type":"application/json","delivery_mode":2}
Payload: {"orderId":10001,"eventType":"ORDER_CREATED"}

Properties 表示需要添加的两个 AMQP 属性;按管理界面的字段输入,不要把它们混进 Payload。

发布一次后,两个队列的 Ready 都应增加 1。再分别发布下列路由键,每次都观察计数的变化:

Routing keyReady 增量
order.createdsms +1,audit +1
order.paidsms +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

Share

If this article helped you, please share it with others!

MQ 从 0 到 1(二):RabbitMQ 基础模型
https://mizuki.mysqil.com/posts/message-queue-02-rabbitmq-basics/
Author
梦幻晨风
Published at
2025-08-17
License
CC BY-NC-SA 4.0

Some information may be outdated

Table of Contents