redis-cli --cluster reshard是最安全的入口,但仅保障数据不丢和集群不断,不保证业务零抖动;手动执行CLUSTER SETSLOT极易因顺序错误、客户端不兼容ASK、缺乏校验重试等导致槽卡住或报错。

直接用 redis-cli --cluster reshard 是最安全的入口,但“安全”不等于“无感”——它只保证数据不丢、集群不断,不保证业务零抖动。
为什么不能跳过 --cluster reshard 直接手动发 CLUSTER SETSLOT
手动执行 CLUSTER SETSLOT importing 和 CLUSTER SETSLOT migrating 看似可控,但极易出错:
- 必须严格按顺序对源节点和目标节点分别执行,漏一步或反了顺序,槽会卡在中间状态,
cluster nodes里显示[slot- 或[slot->target]却无法推进 - 迁移过程中若客户端访问已部分迁移的槽,源节点返回
ASK重定向,但老版本客户端(如 Jedis 3.2 以下)不自动处理ASK,直接报错MOVED或连接拒绝 -
redis-cli --cluster reshard内部会校验节点角色(只从 master 迁)、检查槽是否空闲、自动重试失败的MIGRATE,手动操作得自己写逻辑兜底
redis-cli --cluster reshard 执行时的关键参数控制
交互式提示容易误输,建议用参数预设避免现场手抖:
-
--from:指定源节点 ID(多个用逗号分隔),别用all—— 它会把所有 master 的槽都摊平,可能把本该保留热点的节点也削薄 -
--to:只能填一个目标节点 ID,确认前用redis-cli -p 7000 cluster nodes | grep master核对 ID,别复制错行末的空格 -
--slots:数值要能被 16384 整除后大致均分,例如三主变四主,每个新节点匀 4096 槽(16384 ÷ 4),别凑整数如 5000,否则最后剩的槽难分配 -
--timeout:默认 60000ms,如果单个MIGRATE常超时(比如 key 太大或网络抖动),调高到120000,否则reshard会中断并残留MIGRATING状态
迁移中必须盯住的三个状态信号
执行 reshard 后别立刻切走,用以下命令轮询确认真实进度:
-
redis-cli -p 7000 cluster nodes:看目标节点是否出现connected且槽范围已更新;源节点对应槽段消失才算完成,不是显示 “Done” 就真完了 -
redis-cli -p 7000 cluster info | grep migrating:输出为空才表示没有节点卡在migrating状态;有输出就得查具体是哪个槽、哪个节点 -
redis-cli -c -p 7000 get some_hot_key(带-c启用集群模式):验证客户端能否自动路由,如果报ASK但没重试,说明客户端 SDK 不兼容,得升级或加配置
真正危险的不是迁移本身,而是迁移后节点槽位指派已更新,但某些客户端还缓存着旧的 MOVED 映射,反复打到下线节点上触发重定向风暴。所以缩容前务必确认所有客户端已重建连接,而不是靠等 TTL 过期。











