知识条目 / Redis

Redis 主从报 MASTERDOWN 或全量同步反复如何排查?

先确认网络与主节点状态,再核对 repl-backlog 与复制偏移,避免复制缓冲区过小导致反复全量同步。

MASTERDOWN 表示从节点与主节点连接中断或超时。若恢复后频繁触发全量同步,通常是复制积压缓冲区太小或网络抖动导致偏移量丢失。

处理步骤

  1. 查看复制状态在从节点执行 INFO replication,确认 master_link_status、偏移量与最近同步状态。
  2. 排查网络与主节点检查主节点是否故障切换、网络延迟丢包、防火墙与超时参数 repl-timeout。
  3. 评估部分同步核对 repl-backlog-size 与写入速率,积压不足时从节点断连后会退化为全量同步。
  4. 验证与监控恢复后观察偏移量是否持续增长,监控主从延迟与全量同步次数。

示例

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

官方文档

同库知识