ApsaraMQ for RocketMQ：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版本執行個體，逐步將業務流量遷移至新的執行個體。

業務遷移時，您可以參考以下雙讀雙寫、分批發布的方案進行操作。