知识条目 / Redis
Redis 主从切换与集群异常如何排查?
从复制状态、哨兵或集群选主、客户端路由缓存三个层面还原故障链路,避免盲目重启节点。
Redis 故障通常表现为连接报错或大量超时。先判断是单节点宕机、复制中断还是集群拓扑变化,再确认客户端是否拿到最新拓扑,避免把路由问题误判为数据问题。
处理步骤
- 确认节点与复制状态查看 INFO replication 中主从角色、链路状态与偏移量差异。偏移量持续拉大说明复制延迟,链路断开则要检查网络与认证配置。
- 检查哨兵或集群选主哨兵环境查看 sentinel get-master-addr-by-name 与故障转移日志;集群环境用 CLUSTER INFO 和 CLUSTER NODES 确认槽位归属与节点握手状态。
- 核对客户端拓扑缓存集群客户端会缓存槽位映射,拓扑变化后若未刷新会出现 MOVED、ASK 或持续连旧主。确认客户端版本与重连策略,必要时滚动重启应用连接池。
- 评估数据一致性影响Redis 复制默认异步,切换可能丢失未同步写入。恢复后要核对关键业务数据,并检查是否发生过脑裂导致的双主写入。
示例
INFO replication
INFO sentinel
CLUSTER INFO
CLUSTER NODES
CLUSTER SLOTS
SENTINEL get-master-addr-by-name mymaster
SENTINEL replicas mymaster
故障转移后不要立即重启全部节点。先确认新主可写、旧主已降级为从,避免出现双主写入造成数据分叉。
关键词
redis · 主从 · 主从切换 · 哨兵 · sentinel · cluster · cluster nodes · 脑裂 · 故障转移 · 复制延迟
同库知识
- Redis 内存占用过高如何排查与治理?区分数据增长、过期未释放、复制缓冲区、客户端缓冲和内存碎片,避免只看 used_memory 就扩容。
- Redis 报 OOM command not allowed 如何定位内存来源?先确认 maxmemory 与淘汰策略,再用 memory 与 bigkeys 找出大键和增长来源,避免直接清库。
- Redis 主从报 MASTERDOWN 或全量同步反复如何排查?先确认网络与主节点状态,再核对 repl-backlog 与复制偏移,避免复制缓冲区过小导致反复全量同步。
- Redis Cluster 报 CLUSTERDOWN 或槽未分配如何处理?CLUSTERDOWN 通常表示槽未全覆盖或多数主节点失联,先用 cluster info/nodes 确认槽与节点状态,再恢复节点或修复槽。