版本演进与升级
逐版本差异
| 版本 | 主要变化 | 升级关注点 |
|---|---|---|
| 3.x | NameServer、Broker、CommitLog/ConsumeQueue 和基本消息模型形成 | 历史版本，不用于新部署 |
| 4.0～4.4 | 事务、顺序、延时、过滤和存储能力持续成熟 | 客户端与 Broker 配套、静态主从模式 |
| 4.5～4.9 | DLedger、ACL、批量、运维和稳定性持续增强 | 4.x 存量集群常见升级桥接线 |
| 5.0 | 引入 Proxy、gRPC 客户端、新消息类型与消费模型，架构和 API 出现 Major 边界 | 不能把 4.x Remoting Client 与 5.x gRPC Client 混为同一 API |
| 5.1～5.2 | Proxy、Controller、POP/Simple Consumer、可观测性和云原生持续增强 | 核对 Broker/Proxy/Client 兼容矩阵 |
| 5.3～5.4 | 存储、客户端、主备切换、性能和运维能力持续演进 | 使用最新 Patch，检查默认配置变化 |
| 5.5 | 当前正式主线，最高正式版本为 5.5.0 | 按 Release Notes 验证服务端和各语言 SDK |
从 4.x 升级到 5.x
- 先升级到最新受支持的 4.x Patch，清理弃用参数并验证消息与消费进度。
- 盘点 NameServer、Broker、Dashboard、Remoting Client、Spring 和 Connector 版本。
- 先验证 5.x Broker 对现有 4.x 客户端的兼容，再决定是否引入 Proxy/gRPC 客户端。
- 对顺序、延时、事务、重试、死信、过滤和消费模式分别回归。
- 备份配置、Topic、Subscription Group、ACL、消费 Offset 和存储目录，演练 Broker 回退。
- 如果切换 Controller 或副本模式，单独制定数据复制和选主迁移方案。
版本概念
RocketMQ Server、RocketMQ Remoting Client、gRPC 多语言 Client、RocketMQ Spring、Dashboard 和 Operator 分别发布。选择版本时应使用官方兼容说明，而不是让所有组件机械保持同一个数字。