知识条目 / Redis
Redis 主从报 MASTERDOWN 或全量同步反复如何排查?
先确认网络与主节点状态,再核对 repl-backlog 与复制偏移,避免复制缓冲区过小导致反复全量同步。
MASTERDOWN 表示从节点与主节点连接中断或超时。若恢复后频繁触发全量同步,通常是复制积压缓冲区太小或网络抖动导致偏移量丢失。
处理步骤
- 查看复制状态在从节点执行 INFO replication,确认 master_link_status、偏移量与最近同步状态。
- 排查网络与主节点检查主节点是否故障切换、网络延迟丢包、防火墙与超时参数 repl-timeout。
- 评估部分同步核对 repl-backlog-size 与写入速率,积压不足时从节点断连后会退化为全量同步。
- 验证与监控恢复后观察偏移量是否持续增长,监控主从延迟与全量同步次数。
示例
redis-cli INFO replication
redis-cli CONFIG GET repl-backlog-size
redis-cli CONFIG GET repl-timeout
redis-cli ROLE
全量同步会消耗主节点 CPU、内存与网络;频繁全量同步应先解决网络与积压配置,而不是反复重启从节点。
关键词
redis · masterdown · 主从 · 全量同步 · repl-backlog · 复制偏移 · replication
官方文档
同库知识
- Redis 内存占用过高如何排查与治理?区分数据增长、过期未释放、复制缓冲区、客户端缓冲和内存碎片,避免只看 used_memory 就扩容。
- Redis 主从切换与集群异常如何排查?从复制状态、哨兵或集群选主、客户端路由缓存三个层面还原故障链路,避免盲目重启节点。
- Redis 报 OOM command not allowed 如何定位内存来源?先确认 maxmemory 与淘汰策略,再用 memory 与 bigkeys 找出大键和增长来源,避免直接清库。
- Redis Cluster 报 CLUSTERDOWN 或槽未分配如何处理?CLUSTERDOWN 通常表示槽未全覆盖或多数主节点失联,先用 cluster info/nodes 确认槽与节点状态,再恢复节点或修复槽。