RocketMQ 主题（Topic）详解

最新推荐文章于 2025-09-09 03:40:29 发布

原创最新推荐文章于 2025-09-09 03:40:29 发布 · 895 阅读

13 ·

CC 4.0 BY-SA版权

文章标签：

#rocketmq #Topic #学习

MQ 专栏收录该内容

156 篇文章

订阅专栏

🚀 RocketMQ 主题（Topic）详解

在 Apache RocketMQ 中，主题（Topic） 是消息的逻辑分类单元，是消息生产与消费的核心路由基础。理解 Topic 的设计与使用，是掌握 RocketMQ 架构与应用的关键一步。

一、什么是 Topic？

✅ 定义：

Topic 是一类消息的集合，用于区分不同业务类型或数据流的消息。
生产者将消息发送到指定的 Topic，消费者订阅特定的 Topic 来接收消息。

类比：就像“邮件列表”中的不同栏目，如 订单系统、支付通知、用户行为日志。

📌 举例：

// 生产者发送消息到 ORDER_TOPIC
Message msg = new Message("ORDER_TOPIC", "CREATE", "订单创建".getBytes());

// 消费者订阅 ORDER_TOPIC
consumer.subscribe("ORDER_TOPIC", "*");

二、Topic 的核心作用

作用	说明
消息分类	按业务划分消息类型（如订单、支付、日志）
解耦生产者与消费者	双方只需约定 Topic 名称，无需直接通信
实现路由定位	Broker 通过 Topic 找到对应的 MessageQueue
支持多租户与权限控制	不同团队使用不同 Topic，便于管理
实现负载均衡	一个 Topic 可分布在多个 Broker 上，提升并发能力

三、Topic 与 MessageQueue 的关系

🔗 核心结构：Topic 由多个 MessageQueue 组成

一个 Topic 可以划分为 N 个 MessageQueue（默认 4~8 个，可配置）
每个 MessageQueue 是一个有序、不可变的消息队列
MessageQueue 是并行处理的基本单位

Topic: ORDER_TOPIC
├── MessageQueue 0 → 存储在 Broker-A (Master)
├── MessageQueue 1 → 存储在 Broker-B (Master)
├── MessageQueue 2 → 存储在 Broker-A (Master)
└── MessageQueue 3 → 存储在 Broker-B (Master)

🔄 消息写入过程：

生产者发送消息到 ORDER_TOPIC
Producer 根据负载策略选择一个 MessageQueue（如轮询）
向该 Queue 对应的 Master Broker 发送消息
Broker 将消息追加到 CommitLog，并更新 ConsumeQueue

四、Topic 的关键特性

特性	说明
逻辑存在	Topic 本身不存储数据，只是一个逻辑概念
可跨 Broker 分布	一个 Topic 的 Queue 可分布在多个 Broker 上，实现水平扩展
支持动态扩缩容	可随时增加 MessageQueue 数量或添加新 Broker
支持 Tag 进一步过滤	在订阅时可通过 Tag 筛选子集（如 `CREATE`, `CANCEL`）
支持权限控制	可为不同 Topic 配置读写权限（ACL）

五、Topic 的创建方式

1. 自动创建（默认）

当 Producer 发送消息到一个不存在的 Topic 时，Broker 会自动创建该 Topic。
创建的 Queue 数量由 Broker 配置决定（defaultTopicQueueNums=4）

⚠️ 生产环境建议关闭自动创建，防止误用。

2. 手动创建（推荐）

通过 mqadmin 命令行工具创建：

# 创建 Topic，设置队列数为 8，绑定到特定 Broker 集群
sh mqadmin updateTopic -n 192.168.0.1:9876 -c DefaultCluster -t ORDER_TOPIC -r 8

常用参数：

参数	说明
`-t`	Topic 名称
`-r`	Read Queue 数量（消费队列）
`-w`	Write Queue 数量（写入队列），通常与 `-r` 相同
`-c`	所属 Broker 集群
`-o`	是否为顺序消息（0:否，1:是）

六、Topic 的命名规范（最佳实践）

原则	建议
语义清晰	使用业务含义命名，如 `USER_REGISTER`, `PAYMENT_RESULT`
统一前缀/后缀	按环境区分：`prod_ORDER_TOPIC`, `test_ORDER_TOPIC`
避免特殊字符	只允许字母、数字、下划线、中划线
长度适中	建议 ≤ 64 字符
大小写敏感	RocketMQ 区分大小写，建议统一小写或大写

✅ 推荐格式：

{env}_{domain}_{purpose}[_type]
# 示例：
prod_order_created
test_user_login_log

七、Topic 与消费者组的关系

一个 Topic 可被多个消费者组同时订阅
每个消费者组独立维护自己的消费进度（Offset）
实现 “一对多”广播效果

         +------------------+
         |   Producer       |
         +--------+---------+
                  |
                  v
         +------------------+
         |   Topic: ORDER   |
         +--------+---------+
           /       |        \
          /        |         \
         v         v          v
+--------------+ +--------------+ +--------------+
| ConsumerGroupA| | ConsumerGroupB| | ConsumerGroupC|
+--------------+ +--------------+ +--------------+

📌 场景示例：

Group A：处理订单 → 创建物流单
Group B：统计分析 → 写入数据仓库
Group C：风控系统 → 实时监控异常

✅ 完全解耦，互不影响。

八、Topic 的高级特性

1. 延迟消息（Delay Message）

支持将消息延迟投递（如 1s, 5s, 1m, 2h 等）
需在发送时设置 msg.setDelayTimeLevel(3)（级别 1~18）
所有延迟消息统一存储在 SCHEDULE_TOPIC_XXXX，由定时任务调度

注意：延迟功能依赖特定的系统 Topic，不是每个 Topic 都能直接支持延迟。

2. 事务消息

支持“半消息”机制，实现本地事务与消息发送的一致性
事务消息仍发送到普通 Topic，但 Broker 会先标记为“不可见”

3. 顺序消息

保证同一个 MessageQueue 的消息按序消费
需生产者和消费者都启用顺序模式
适用于订单状态流转、交易流水等场景

九、Topic 的管理与监控

1. 查看 Topic 列表

sh mqadmin topicList -n 192.168.0.1:9876

2. 查看 Topic 详情

sh mqadmin topicStatus -n 192.168.0.1:9876 -t ORDER_TOPIC

3. 删除 Topic（慎用）

sh mqadmin deleteTopic -n 192.168.0.1:9876 -c DefaultCluster -t ORDER_TOPIC

⚠️ 删除后消息不会立即清除，需等待过期（默认 72 小时）

4. 监控消费进度

sh mqadmin consumerProgress -n 192.168.0.1:9876 -g my_consumer_group

十、常见问题与注意事项

问题	原因	建议
`NO_TOPIC_ROUTE_INFO`	Topic 未创建或路由未同步	手动创建 Topic 或等待路由更新
消费积压	Queue 数量少，消费者处理慢	增加 Queue 数或扩容消费者
路由不一致	Broker 未正确注册	检查 Broker 是否正常运行并连接 NameServer
自动创建过多 Topic	开发环境滥用	生产环境关闭 `autoCreateTopicEnable`
消息乱序	使用了集群模式但期望顺序	改用顺序消息或单 Queue 设计

✅ 总结：Topic 核心要点

维度	说明
角色	消息的逻辑分类与路由基础
组成	由多个 MessageQueue 构成，分布于多个 Broker
生命周期	可手动或自动创建，支持动态扩缩容
并发能力	由 Queue 数量决定最大并行度
解耦能力	支持多消费者组独立订阅
高级功能	支持延迟、事务、顺序消息
管理方式	通过 `mqadmin` 工具或 API 管理