文档中心

消息队列 RocketMQ版

业务迁移

迁移概述

本指南主要为用户提供 RocketMQ 的迁移方案建议与操作指导。

背景信息

火山引擎基于Apache RocketMQ 构建了稳定、安全的消息队列 RocketMQ版。与和开源 RocketMQ 相比，消息队列 RocketMQ版支持 VPC 访问，免部署免运维，具备更高的稳定性和安全性，支持消息查询、全链路消息轨迹查询以及消息回溯等功能，帮助您快速发现和处理系统问题，提高运维效率。

RocketMQ 业务迁移是指将自建或其他云厂商的 RocketMQ 迁移到火山引擎消息队列 RocketMQ版。对于消息队列来说，如需在业务运行过程中实现集群迁移，只需消费完旧集群的消息即可。

迁移类型

目前火山引擎消息队列 RocketMQ版支持以下类型的 RocketMQ 迁移。

自建 RocketMQ 业务迁移。所有的生产者和消费者都从自建集群迁移到火山引擎消息队列 RocketMQ版集群上，所有的消息收发都在消息队列 RocketMQ版集群中完成。

迁移其他云厂商 RocketMQ。从其他云厂商的 RocketMQ 集群迁移至火山引擎消息队列 RocketMQ版集群中，迁移时可以通过云监控检查每个步骤的执行情况，确保无消息堆积、业务无影响无感知。

迁移方案

消息队列 RocketMQ版提供以下两种迁移方案供您选择，请根据自身业务特点谨慎选择。

如果您的 RocketMQ 为集群化部署，建议采用分批发布方案逐台迁移，使生产者集群与消费者集群在旧集群与新集群上并行运行，实现业务平滑过渡、上层无感知。

方案	说明	适用场景
方案一（推荐）	先建立新的消息生产与消费流程，新旧生产端和消费端并行运行。待旧集群的存量消息被旧消费端消费完成后，再下线旧生产端和旧消费端。	该方案无法保障消息消费的有序性，适用于对消息消费时序不敏感或对有序消息无依赖的业务场景，例如高并发场景下的订单提交。
方案二	先迁移生产端到新集群，旧生产端下线。待旧集群的存量消息被旧消费端消费完成后，再迁移消费端，启动新的消费端开始消费。	适用于对消息顺序有严格要求的业务场景，例如 MySQL 的 binlog 日志消费。

迁移流程

环境准备

迁移之前，您需要根据业务量合理评估资源需求，并创建 RocketMQ 实例及相关的依赖资源。

迁移元数据

将开源 RocketMQ 的 Topic 和 Group 的配置信息迁移到消息队列 RocketMQ版上，包括 Topic 名称、队列个数和权限在内的配置信息均需要迁移。

迁移消息服务

方案一：先建立新的消息生产与消费流程，新旧生产端和消费端并行运行。待旧集群的存量消息被旧消费端消费完成后，再下线旧生产端和旧消费端。

方案二：先迁移生产端到新集群，旧生产端下线。待旧集群的存量消息被旧消费端消费完成后，再迁移消费端，启动新的消费端开始消费。

确认迁移结果

观察新实例和旧实例的生产和消费相关状态与流量数据，确认业务已成功迁移至新实例。

最近更新时间：2026.04.01 10:54:34

这个页面对您有帮助吗？

有用

无用