知识条目 / Redis

Redis 主从切换与集群异常如何排查?

从复制状态、哨兵或集群选主、客户端路由缓存三个层面还原故障链路,避免盲目重启节点。

Redis 故障通常表现为连接报错或大量超时。先判断是单节点宕机、复制中断还是集群拓扑变化,再确认客户端是否拿到最新拓扑,避免把路由问题误判为数据问题。

处理步骤

  1. 确认节点与复制状态查看 INFO replication 中主从角色、链路状态与偏移量差异。偏移量持续拉大说明复制延迟,链路断开则要检查网络与认证配置。
  2. 检查哨兵或集群选主哨兵环境查看 sentinel get-master-addr-by-name 与故障转移日志;集群环境用 CLUSTER INFO 和 CLUSTER NODES 确认槽位归属与节点握手状态。
  3. 核对客户端拓扑缓存集群客户端会缓存槽位映射,拓扑变化后若未刷新会出现 MOVED、ASK 或持续连旧主。确认客户端版本与重连策略,必要时滚动重启应用连接池。
  4. 评估数据一致性影响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 · 脑裂 · 故障转移 · 复制延迟

同库知识