3. 迁移场景分类：集群扩容迁移、跨机房迁移、版本升级迁移、Topic重分区迁移

Kafka 迁移并非单一操作，不同迁移场景对集群负载、网络带宽、磁盘 I/O 以及 JVM 堆内存的压力模型截然不同。理解迁移场景的分类，是制定慢查询与 GC 停顿联合调优策略的前提。本章将四种核心迁移场景的技术特征、数据流变化及调优关注点进行结构化对比。

3.1 迁移场景全景对比

3.2 集群扩容迁移

集群扩容迁移是最常见的水平扩展场景。当集群整体吞吐或磁盘容量接近阈值时，运维人员向集群添加新的 Broker 节点，并通过 kafka-reassign-partitions.sh 将部分分区副本迁移至新节点。

• 数据流特征： 迁移期间，源 Broker 同时承担生产消费流量与副本数据传输（Fetch/Follower 请求），磁盘 I/O 和网络出向带宽成为瓶颈。
• 慢查询风险： 磁盘 I/O 饱和导致日志刷盘延迟增加，Producer 请求 等待 ack 时间变长，表现为端到端延迟抖动。
• GC 风险： 大量副本同步请求导致 JVM 堆内临时对象（如 FetchResponse 缓冲区）快速膨胀，Young GC 频率升高，若晋升率过高则触发 Full GC。

3.3 跨机房迁移

跨机房迁移通常采用 MirrorMaker 2.0 或 Confluent Cluster Linking 实现。源集群与目标集群位于不同数据中心，网络延迟通常在 10ms~100ms 级别，且存在带宽限制。

• 数据流特征： 全量同步阶段，MirrorMaker 消费者从源集群拉取历史数据，生产者写入目标集群。增量阶段持续同步实时消息。
• 慢查询风险： 消费者端 fetch.max.wait.ms 与网络延迟叠加，导致消费滞后（Consumer Lag）波动；生产者端 acks=all 时，跨机房 ack 等待时间显著增加。
• GC 风险： MirrorMaker 进程需要缓存大量待同步消息，堆内存中 RecordBatch 对象堆积，老年代占用率持续上升，极易触发并发标记清除（CMS）或 G1 的 Mixed GC。

3.4 版本升级迁移

版本升级迁移分为原地滚动升级和搭建新集群迁移两种方式。Kafka 2.x 到 3.x 的升级涉及 ZooKeeper 到 KRaft 的元数据架构变更，迁移复杂度最高。

• 数据流特征： 滚动升级时，Broker 依次重启，分区 Leader 发生短暂切换；新集群迁移则需全量数据拷贝。
• 慢查询风险： 协议版本不匹配时，客户端与 Broker 之间可能降级使用旧协议，导致序列化/反序列化性能下降。
• GC 风险： 新版本可能引入新的内存管理策略（如从 ConcurrentSkipListMap 到 Varint 编码），JVM 堆内存分配模式变化，需重新调优 GC 参数。

# 版本升级迁移时推荐的 Broker JVM 参数调整示例
# 针对 Kafka 3.x + G1GC
-XX:+UseG1GC
-XX:MaxGCPauseMillis=100
-XX:G1HeapRegionSize=16m
-XX:InitiatingHeapOccupancyPercent=70
-XX:+ParallelRefProcEnabled
-XX:+UnlockExperimentalVMOptions
-XX:G1MixedGCLiveThresholdPercent=85

3.5 Topic 重分区迁移

Topic 重分区迁移通常发生在分区数不足导致单分区吞吐瓶颈，或分区分布不均匀造成热点 Broker 时。通过 kafka-reassign-partitions.sh 或 kafka-admin.sh --alter --partitions 执行。

• 数据流特征： 增加分区数时，现有分区数据不会自动重新分布，仅新消息写入新分区。Reassign 操作则涉及分区副本在 Broker 间的物理移动。
• 慢查询风险： Reassign 期间，源分区 Leader 需要同时服务生产消费和副本复制，磁盘寻道时间增加，kafka.log:type=Log,name=LogFlushRateAndTimeMs 指标恶化。
• GC 风险： 分区 reassign 会触发大量 LeaderAndIsr 请求，Controller 端需要频繁更新元数据缓存，导致 Controller 的 JVM 老年代快速膨胀。

3.6 迁移场景与 GC 停顿关联矩阵

下表总结了四种迁移场景下，GC 停顿的主要诱因及推荐调优方向：

3.7 迁移场景分类总览图

下图展示了四种迁移场景在数据流方向、操作对象和主要风险维度上的分类关系：

3.8 迁移场景选择决策树

在实际运维中，选择哪种迁移方式取决于业务需求与集群现状。以下决策树帮助快速定位：