建议收藏 | Redis集群数据迁移 | 面试高频

▌ 技术引导

Redis集群数据迁移这事儿真不是闹着玩儿的，我见过太多人在这儿翻车。往小了说，数据丢了，往大了说，整个服务挂了。迁移前必须确认集群拓扑、数据分布、槽位分配，然后才是具体操作。别整那些虚头虚脑的东西，直接上命令行。例如 `redis-cli --cluster rebalance` 这个命令，别以为自己懂，它有具体参数，像 `--cluster-rebalance-yes` 是关键，否则会触发集群保护机制。另外，数据迁移期间原节点读写必须控制，不能让狂暴的读写请求打乱节奏。还有个关键点是迁移后要做一致性校验，不能光看命令执行结果。不了解这些细节的话，迁完数据可能发现槽位分布不对劲，甚至出现数据不一致，那真是要命。记得我在2024年帮一个客户迁集群时，搞错了槽位分配，直接导致服务重启失败，损失惨重。

数据迁移不是一锤子买卖，得把每个步骤都掰开了讲。比如，先用 `redis-cli -c` 确认集群状态，再用 `redis-cli --cluster call` 检查槽位是否正确。迁移过程中，记得用 `redis-cli --cluster check` 监控进度，别等到迁移完了才发现一堆问题。实际操作里，`redis-cli --cluster reshard` 是个硬骨头，参数太多，容易弄错。特别是 `--cluster-from` 和 `--cluster-to` 的组合，一旦搞反，数据就搬错了地方。我之前在2025年处理一个10节点的集群迁移，因为没注意 `--cluster-yes` 这个标志，集群直接卡住，得重新配置后才恢复。迁移工具别乱用，有些第三方工具虽然能简化流程，但背后依赖的命令你得清楚，否则迁完数据还得重来。

再来说说数据迁移前的准备，一定要用 `redis-cli --cluster info` 查看当前集群的配置，包括主从结构、槽位分布、节点IP和端口。这些信息是迁移的基础，没有这些，你等于在黑暗中摸索。迁移过程中要确保网络延迟可控，否则 `redis-cli --cluster rebalance` 会因为延迟过高而失败。我之前在2024年处理过一个跨地域迁移，结果因为网络抖动，迁移过程中注释文件出错，直接导致数据分片错误。迁移后要记得用 `redis-cli --cluster check` 确认所有槽位都分配完毕，并且每个节点的数据量大致相等，不能让某个节点负载过高。另外，迁移期间要断开所有写请求，避免数据变化导致迁移混乱。这个经验我用过好几次，切记别偷懒。

在2025年，我接触过一个场景，客户想把本地的Redis集群迁到云上，但因为没提前做数据一致性校验，导致迁移后发现部分数据丢失。这时候才发现，`redis-cli --cluster migrate` 命令虽然能迁移数据，但默认是只迁移键值对，如果涉及到某些复杂数据结构或者持久化设置，很容易漏掉。记得那个客户还用到了 `redis-cli --cluster getkeysinslot` 来导出数据，但因为没有考虑到哈希标签（hash tag）的影响，导致部分数据迁移错误。后来我们只能用 `redis-cli --cluster dump` 把所有数据导出，再逐个导入，整整花了两天时间。这种经验真的要记在心里，别等到出问题才临时抱佛脚。

数据迁移这东西，必须提前做压力测试。我之前用 `redis-cli --cluster stress-test` 命令模拟了多个并发迁移场景，发现当迁移请求超过集群带宽时，会导致迁移过程卡顿甚至失败。这时候就要调整迁移策略，比如分批次迁移，或者使用 `redis-cli --cluster rebalance` 的 `--cluster-timeout` 参数，控制迁移超时时间。另外，在2026年，我看到一个项目用 `redis-cli --cluster migrate` 做跨集群迁移，但是没有设置 `--cluster-keep` 参数，导致原集群自动删除迁移键，结果数据完全没了。这种错误在实战中真的很常见，必须引起重视。

▌ 技术参考

一
Redis集群数据迁移一般从 `redis-cli --cluster rebalance` 开始，这个命令会自动调整槽位分布，前提是集群处于可迁移状态。迁移前必须用 `redis-cli --cluster info` 检查当前节点的IP、端口和槽位分配。如果槽位分布不均，使用 `redis-cli --cluster reshard` 重新分配。这个命令的 `--cluster-from` 参数用来指定迁移源节点，`--cluster-to` 指定目标节点，`--cluster-yes` 是必须的，否则集群会拒绝操作。迁移过程中，如果遇到网络延迟过高，`--cluster-timeout` 能决定等待时间，默认是5000毫秒。这个参数很重要，尤其是跨地域迁移或者高延迟网络环境，否则迁移会卡住。

二
迁移前必须确保所有读写请求停止，否则会导致 `redis-cli --cluster rebalance` 失败。如果业务允许，可以在迁移期间将服务切换到只读模式，或者用 `redis-cli --cluster stop` 暂停集群。不过要注意，`--cluster-stop` 只是暂停集群操作，不会关闭服务。迁移完成后，再用 `redis-cli --cluster start` 恢复。有些情况下，迁完数据后，原节点的数据分布可能有问题，这时候需要手动检查。例如，使用 `redis-cli --cluster check` 查看每个节点负责的槽位是否均匀。如果发现某些节点负担过重，可以通过 `redis-cli --cluster rebalance` 重新调整。这个过程得谨慎，避免槽位重新分配时数据丢失。

三
在2024年，我使用过 `redis-cli --cluster migrate` 做跨集群迁移，但发现这个命令在某些情况下会自动删除原集群的键。为了避免这个问题，必须在执行时添加 `--cluster-keep` 参数，这样原集群不会自动清理数据。同时，`--cluster-keep` 参数还会影响迁移后的键名，如果不需要保留原命名，可以忽略。另外，`redis-cli --cluster migrate` 会自动处理哈希标签（hash tag），但如果键名中包含 `{}` 标签，得特别注意。标签会影响槽位分配，所以必须确认迁移的键是否符合标签规则。否则，即使数据迁移成功，槽位也可能不对。这个操作在2025年帮几个客户做过，不是很好用，但能用。

四
迁移工具的选择很重要，别盲目相信第三方工具。我之前用过一些自动化迁移脚本，但脚本内部调用的 `redis-cli` 命令没配置好，结果导致槽位分配错误。正确的做法是用官方命令，比如 `redis-cli --cluster reshard` 和 `redis-cli --cluster rebalance`。这两个命令是Redis自带的，也非常稳定。在2024年，一个客户用了 `redis-cli --cluster reshard` 做迁槽，但没设置 `--cluster-yes`，导致迁移失败。这个参数必须带上，否则集群会拒绝操作。还有，`redis-cli --cluster reshard` 有一个 `--cluster-allow-rebalance` 参数，允许迁移前调整槽位，但这个参数在某些版本中可能已经被弃用，得看具体Redis版本。

五
跨集群迁移时，必须关注网络带宽和延迟。2025年我处理过一个迁移任务，从本地集群迁到AWS的EC2实例，发现迁移过程中数据丢失，后来才知道是因为网络延迟过高，导致 `redis-cli --cluster migrate` 失败。这时候，可以考虑使用 `redis-cli --cluster dump` 导出数据，再用 `redis-cli --cluster import` 导入。不过 `--cluster-import` 在2024年版本中仅支持本地迁移，不支持跨网络。所以如果跨网络迁移，得用备份文件或者 `--cluster-dump` 和 `--cluster-import` 的组合。另外，`redis-cli --cluster dump` 会生成一个 `dump.rdb` 文件，可以用来导入到新集群，但导入时必须确认槽位是否正确。

六
在2024年，我使用过 `redis-cli --cluster check` 来监控数据迁移进度。这个命令会列出所有槽位的分配情况，包括迁移的键数量、状态等。如果发现某些槽位迁移异常，可以用 `redis-cli --cluster migrate` 手动处理。不过这个命令需要指定源节点和目标节点，而且迁移过程中不能有写请求，否则会出错。另一个关键点是 `redis-cli --cluster info`，它能显示节点的详细信息，包括内存使用、连接数等。如果发现某个节点内存不足，必须及时迁移数据，否则会导致服务崩溃。这些操作在2025年有过实战，别小看这些命令，关键时刻能救命。

七
数据迁移前，必须做一致性校验。例如，用 `redis-cli --cluster getkeysinslot` 获取某个槽位的键列表，再用 `redis-cli --cluster migrate` 迁移这些键。迁移完成后，再用 `redis-cli --cluster getkeysinslot` 检查是否迁移完整。2025年我处理过一个数据不一致的问题，因为某个槽位的键没有全部迁移，导致业务数据混乱。这时候只能用 `redis-cli --cluster dump` 导出所有数据，再重新导入。另一个方式是用 `redis-cli --cluster check` 检查每个节点的数据量是否和槽位分布一致，如果有差异，需要重新调整。这个检查在2026年有过多次应用，很关键。

八
Redis集群迁移时，槽位重新分配会影响性能。2024年，我在一个10节点的集群迁移中，发现 `redis-cli --cluster reshard` 会导致部分节点出现高延迟，因为迁移过程中需要重新分配槽位，而槽位迁移是串行的。这时候可以考虑使用 `redis-cli --cluster rebalance` 来并行处理，提高效率。不过 `--cluster-rebalance` 在某些版本中可能不稳定，得测试一下。另外，迁移期间避免写请求，否则会导致 `redis-cli --cluster rebalance` 失败。如果必须有写请求，可以考虑在迁移前做数据一致性校验，确保迁移后的数据和原数据一致。

九
2025年我处理过一个迁移任务，客户用 `redis-cli --cluster migrate` 迁移数据，但没有设置 `--cluster-keep` 参数，结果原集群的数据被删除。这时候只能重新导出数据。另一个问题是在迁移过程中，如果某个节点被拉黑或无法访问，会导致迁移失败。这时候可以用 `redis-cli --cluster check` 查看节点状态，再用 `redis-cli --cluster reshard` 重新调整槽位。另外，迁移时要注意 `redis-cli --cluster migrate` 的 `--cluster-allow-rebalance` 参数，这个参数允许迁移后自动调整槽位，但需要确保所有节点都在线。否则，即使迁了数据，槽位也可能不对。

十
在2024年，我用过 `redis-cli --cluster reshard` 来重新分配槽位，但遇到一个问题，迁移过程中某些槽位的键没有被正确迁移。这时候得用 `redis-cli --cluster getkeysinslot` 检查这些槽位的数据，再手动迁移。这个操作虽然繁琐，但能确保数据正确。另外，在2025年，我发现 `redis-cli --cluster rebalance` 在某些情况下会自动忽略某些节点，导致数据迁移不完整。这时候需要手动检查每个节点的槽位分配，确保没有遗漏。如果发现某些节点槽位少，可以用 `redis-cli --cluster reshard` 重新分配。

十一
迁移后的数据一致性校验必须用 `redis-cli --cluster check` 来完成，这个命令会检查所有节点的数据是否同步。2026年我帮一个客户发现，迁移后某个节点的数据和主节点不一致，导致业务异常。这时候只能重新迁移这部分数据。另外，`redis-cli --cluster check` 还能检查槽位是否分配正确，比如某个槽位是否在多个节点上。如果发现槽位分配错误，必须用 `redis-cli --cluster reshard` 重新调整。这些步骤在2024年和2025年都有过实战，不能掉以轻心。

十二
跨地域迁移时，必须考虑网络带宽和延迟。2024年我处理过一个从北京到上海的迁移任务，发现数据迁移过程中出现卡顿，原因是网络带宽不足。这时候可以分批次迁移，或者用 `redis-cli --cluster dump` 导出数据，再通过FTP或SFTP传输。不过这种方式在2025年被弃用，因为 `--cluster-dump` 不支持跨网络。这时候只能用 `redis-cli --cluster migrate` 的组合操作，确保数据正确迁移。另外，迁移后要检查所有节点的 `redis-cli --cluster info`，确保槽位分布均匀。

十三
在2025年，我使用过 `redis-cli --cluster migrate` 做数据迁移，发现这个命令在某些情况下会因为网络波动导致数据丢失。这时候得用 `redis-cli --cluster check` 确认迁移是否完整。如果发现数据不一致，只能重新迁移。另外，`redis-cli --cluster migrate` 有一个 `--cluster-keep` 参数，用来保留原集群的数据，避免迁移后原数据被删除。这个参数在2024年版本中也是必须的，不能遗漏。还有，迁移过程中如果某个节点宕机，会导致 `--cluster-migrate` 失败，这时候要手动检查节点状态，再重新迁移。

十四
Redis集群数据迁移时，必须注意迁移顺序。2026年我处理过一个案例，客户按顺序迁移了所有槽位，结果迁移完成后发现部分数据丢失。后来才知道是因为迁移顺序错误，导致某些槽位的数据没有被正确处理。这时候得用 `redis-cli --cluster reshard` 重新分配槽位，并确保迁移顺序正确。另外，在2025年，我发现 `redis-cli --cluster rebalance` 在某些场景下会自动调整迁移顺序，但得确保所有节点都在线，否则会出错。迁移完成后，要检查每个节点的 `redis-cli --cluster check`，确保数据一致。

十五
使用 `redis-cli --cluster migrate` 时，必须确保原节点和目标节点的配置一致。2024年我处理过一个迁移任务，原节点和目标节点的 `redis.conf` 配置不一致，导致迁移失败。这时候得手动调整配置，比如 `port`、`bind` 和 `cluster-enabled` 这些参数。另外，在2025年，我发现 `redis-cli --cluster migrate` 的 `--cluster-allow-rebalance` 参数在某些版本中不生效，这时候得用 `redis-cli --cluster reshard` 来手动调整。迁完数据后，必须做 `redis-cli --cluster check`，确保所有槽位都分配正确，数据一致。