4.x和5.x版本差异及兼容性说明

5.x版本优势

和历史服务端版本相比，云消息队列 RocketMQ 版5.x版本具有如下优势：

• 架构更先进

  全面采用存储和计算分离的消息架构，存储和计算可以独立按需水平扩展，满足高效弹性运维和高性能大规格能力的诉求。

• 开发门槛更低

  主推和Apache RocketMQ完全一致的客户端SDK接入，同时兼容历史所有版本的SDK和API接口。

  支持VPC内部安全识别，上云只需修改接入点，无需考虑代码改造。

• 运维门槛更低

  针对线上容量水位评估、业务峰谷弹性、日常灰度环境等常见困难问题提供自适应弹性、轻量测试环境版等解决方案，整体运维门槛和风险更低。

• 成本更弹性

  通过云底座技术优化，消息收发计算能力支持预留+突发流量弹性组合，业务方无需为突发流量预留大量Buffer。

  消息存储按量使用付费，相比挂载云盘无法缩容的情况，具备极大的弹性优势。

• 售卖形态更完善

  提供更完善阶梯系列，提供完整的包月和小时价售卖形态。

• 全新LiteTopic模型更好支持AI应用异步通信

  针对AI业务任务处理耗时长、算力资源稀缺且成本高昂、算力利用率与业务峰谷波动矛盾等普遍痛点问题，提供了轻量主题功能与配套解决方案，开发者可以轻松构建健壮、高效、可扩展的异步通信体系，并平滑请求峰谷，缓解后端处理压力，从而提升资源利用率、节约成本。

各版本SDK说明

使用 rocketmq-spring-boot-starter 或 ons-client 从 4.x 迁移到 5.x 时，请注意以下 Spring Boot Starter 兼容性和 JDK 兼容性问题：

• Starter 替换说明：不能将 rocketmq-spring-boot-starter 直接替换为 rocketmq-v5-client-spring-boot-starter 以兼容原有配置。两者底层协议不同（前者为 Remoting 协议，后者为 gRPC 协议），配置项差异较大（name-server vs endpoints），且 SimpleConsumer 不支持 @RocketMQMessageListener 注解，需要手动调用接口消费消息。

• Starter 共存冲突：rocketmq-spring-boot-starter 与 rocketmq-v5-client-spring-boot-starter 不能同时引入，否则会导致类冲突或行为异常。建议根据实例版本选择其中一个。

• 混合使用风险：保留 rocketmq-spring-boot-starter 并引入 rocketmq-client-java 使用 SimpleConsumer，虽然技术上可行（协议与包路径不同，不会直接冲突），但维护成本较高，且无法享受 v5 Starter 的统一开发体验，不推荐此方式。

• JDK 兼容性：ons-client 1.8.4 版本不完全兼容 JDK17，会导致服务无法启动。如果使用 JDK17，请将 ons-client 升级至 1.9.1.Final 及以上版本。

4.x和5.x功能兼容说明

云消息队列 RocketMQ 版5.x版本实例基于大规模企业客户的生产实践经验，对消息收发流程中的部分功能行为进行了优化调整。因此，部分场景下的参数配置、功能行为会有差异，一般情况下不影响主要消息收发链路，对于存量4.x版本升级到5.x版本，请您根据业务情况评估风险。

具体的功能行为差异如下：

购买限制

• 云消息队列 RocketMQ 版5.x版本实例面向所有用户提供购买开通服务。

• 云消息队列 RocketMQ 版4.x版本实例仅支持针对存量用户开放购买，建议您尽量将实例版本升级到5.x，如有升级诉求，请提交工单咨询。

4.x版本至5.x版本升级说明

当前暂不支持使用升级工具将4.x版本实例原地升级到5.x版本。如果您需要将存量实例升级至5.x版本实例，建议您参考如下流程购买5.x版本实例，逐步将业务流量迁移至新的实例。

业务迁移时，您可以参考以下双读双写、分批发布的方案进行操作。