Redis集群数据迁移实战：从主从架构平滑升级到Redis Cluster

Redis集群数据迁移是缓存架构升级的必经之路。业务从单机或主从模式迁到Redis Cluster，涉及数据搬运、客户端兼容、槽位分布三件事。本文用redis-cli –cluster命令演示如何无损迁移并验证集群一致性。

Redis集群迁移前置评估：容量、版本与客户端

迁移前先评估三个硬指标：单机内存占用与集群目标总内存的比例，建议集群总内存余量30%以上；版本统一到6.x以上，支持主从部分重同步；客户端库支持cluster模式，Redis Cluster下jedis、go-redis的cluster客户端都有槽位路由能力，Spring Data Redis需配ClusterConnectionFactory。

明确迁移SLA：允许的写停机窗口，窗口大可选离线迁移，全量备份加增量回放；窗口小选在线迁移。

在线迁移方案：redis-cli –cluster平滑迁移

官方工具自带迁移命令，在目标集群第一个节点上执行：

redis-cli --cluster import 127.0.0.1:6379   --cluster-from 192.168.1.10:6379   --cluster-copy   --cluster-replace

–cluster-from指定源节点，–cluster-copy保留源数据不删，–cluster-replace目标节点已存在的key自动覆盖。导入过程按槽位分片拉取，适合中小规模数据（千万级key）。

亿级key的大集群改用redis-shake（支持全量加增量双通道），先全量搬底，再持续追增量，配合写切换做到分钟级停写。

业务切换与数据一致性校验

切换分三步：应用层先切读流量到集群（灰度10%），观察错误率与延迟；写流量切完后，用脚本对比源与目标的key数量、TTL、抽样值；验证无误后正式生效。

校验脚本要点：遍历源库dbsize对比；抽样1000个key用DUMP对比；重点比对hash、zset、stream等复合类型的长度。

迁移后性能验证与回滚预案

迁移后压测验证：pipeline批量写入延迟、热点key的集中访问是否触发了slot重定向（CLUSTER MOVED）。moved重定向次数过多说明客户端路由未生效，排查客户端cluster配置。

回滚预案：保留旧节点数据48小时，旧节点只读模式开放，切换失败回滚时改回客户端旧地址即可。全程记录迁移前后监控指标（内存、命中率、每秒操作数），作为容量与性能基线。

长稳观察：升级后的高可用验证

集群上线后做一次failover演练：kill一个master，确认slave自动提升、槽位分配不散、客户端无长时间中断；验证故障节点恢复后自动回归集群。这套流程确认后再接入核心业务流量，才算迁移真正完成。