AOF损坏需先用redis-check-aof --fix截断修复,再手动删中间非法命令并二次校验;恢复数据须关闭cluster-enabled、清nodes.conf后单机启动;集群重建需先CLUSTER MEET加入、确保无槽冲突、主节点身份,再addslots,并设cluster-require-full-coverage no。

主从全挂后 AOF 文件损坏怎么救
Redis 集群主从节点全部宕机,且 AOF 文件因写入中断或磁盘异常出现损坏(比如末尾截断、非法命令格式),redis-server 启动时会直接报错退出,典型错误是:Bad file format reading the append only file 或 Unexpected EOF reading the append only file。
不能跳过校验硬启,也不能删 AOF 重来(数据就丢了)。必须人工修复 AOF 文件本身:
- 用
redis-check-aof --fix自动截掉损坏尾部(它只删不修,适用于末尾乱码但前面完整) - 若损坏在中间(比如某条
set命令缺了参数),得手动打开 AOF 文件,定位到出错行附近,删掉那条不完整的命令(注意保留合法的*N\r\n$M\r\n...结构) - 修复后务必用
redis-check-aof --fix再跑一次验证,输出 “AOF analyzed: X commands, Y errors” 中 Y 必须为 0 - 别用文本编辑器在 Windows 下改——换行符(
\r\n)被转成\n会导致解析失败
修复完 AOF 启动单节点但 cluster-enabled 报错
单独启动一个修复好的节点,如果 redis.conf 里还开着 cluster-enabled yes,它会尝试读取 nodes.conf 并连接其他节点,但此时集群已空,会卡在等待握手或报 Node is not ready,根本进不了 REPL 状态。
必须临时关闭集群模式才能加载 AOF 数据:
- 把配置里的
cluster-enabled yes改成cluster-enabled no - 删掉旧的
nodes.conf(否则重启后仍试图走集群逻辑) - 启动 Redis,确认
INFO replication显示role:master且connected_slaves:0,再用KEYS *或DBSIZE验证数据已载入 - 切记:这一步只是“数据恢复”,不是“集群恢复”——此时它只是一个普通单机 Redis
用 cluster addslots 重新分配槽位前必须满足的条件
CLUSTER ADDSLOTS 不是万能补丁,它只在节点已处于集群模式、且自身状态为 fail 或 noaddr 以外的正常状态时才接受指令。常见失败原因:
- 节点还没执行
CLUSTER MEET加入集群 —— 先用redis-cli -p 6379 CLUSTER MEET <other-node-ip><other-node-port></other-node-port></other-node-ip>拉起通信 - 目标槽位已被其他节点声明(
CLUSTER SLOTS查看当前分配)—— 必须先用CLUSTER DELSLOTS清空冲突槽,或让原节点下线(CLUSTER FORGET) - 节点未通过
CLUSTER REPLICATE <node-id></node-id>设置从属关系就直接加槽 —— 主节点才能持有槽位,从节点只能复制,加了也无效 - 所有参与节点的
cluster-config-file路径要一致,否则nodes.conf同步失败,槽位分配不持久
为什么 cluster addslots 后客户端仍连不上对应 key
加完槽位不代表路由立刻生效。客户端(尤其是老版本 Jedis/Lettuce)缓存了旧的 slots 映射,或者 Redis 节点没广播变更,导致 MOVED 重定向指向错误节点。
关键动作不是多试几次 addslots,而是触发集群状态同步:
- 对每个刚分配完槽的节点,执行
redis-cli -p 6379 CLUSTER SETSLOT <slot> STABLE</slot>(逐个刷)或等 10 秒让 gossip 自动传播(不保险) - 强制客户端刷新路由:Jedis 调
close()+ 新建连接;Lettuce 用ClusterTopologyRefreshOptions开启自适应刷新 - 用
redis-cli -c -p 6379 GET somekey测试,看是否返回MOVED或直接命中 —— 如果还跳转到下线节点,说明nodes.conf没更新成功,需检查磁盘权限和配置文件路径
最易被忽略的是:所有节点的 cluster-require-full-coverage no 必须设为 no,否则只要有一个槽没分配,整个集群拒绝服务,addslots 成功也白搭。

















