PSYNC返回FULLRESYNC的常见触发条件是:replid不匹配、offset超出repl-backlog有效范围、repl-backlog-size过小导致缓冲区覆盖、从库重启或主库重启/DEBUG RELOAD致ID重置。

PSYNC返回FULLRESYNC的常见触发条件
生产环境里从库反复触发全量同步(FULLRESYNC),不是Redis坏了,而是主从之间“断连重试”或“offset对不上”导致PSYNC协议自动降级。PSYNC本意是优先走增量同步(PARTIALRESYNC),但只要满足以下任一条件,就会 fallback 到全量:repl-backlog-buffer被覆盖、从库上报的replication offset超出缓冲区范围、主库replication id已变更(比如主库重启或手动DEBUG RELOAD)、从库初次连接或断连超时后重连未携带有效offset。
repl-backlog-size配置不足是最常被忽略的原因
默认repl-backlog-size只有1MB,而生产环境写入QPS高、网络偶发抖动时,几秒内就能把缓冲区填满。一旦从库断连超过缓冲区能承载的时间窗口,再连上来时它报的offset就失效了,主库只能给FULLRESYNC。这不是bug,是设计使然——缓冲区本质是个环形队列,旧命令被新命令覆盖后不可恢复。
- 估算公式:缓冲区大小 ≈ 主库每秒写命令字节数 × 断连容忍时间(秒)
- 典型调优值:16MB 或 64MB(
config set repl-backlog-size 16mb) - 注意:该配置只在主库生效,且需在从库连接前设置,运行中修改对已连接从库不立即生效
从库断连后重连未带offset或ID不匹配
从库重启、网络闪断、或人为执行slaveof no one后再slaveof,都会导致它丢失上次同步状态。此时它发起PSYNC时会传? -1,主库一看offset无效,直接回FULLRESYNC。更隐蔽的是replication id不一致:主库重启后生成新id,但老从库还记着旧id,PSYNC请求里带的旧id不被认可,也会强制全量。
- 验证方法:在从库执行
info replication,检查master_replid是否与主库一致 - 主库查看当前id:执行
info server | grep run_id(注意run_id≠master_replid,后者才是复制ID) - 避免ID突变:禁用
DEBUG RELOAD,主库升级尽量平滑滚动,而非直接kill -9后拉起
无盘复制(diskless replication)开启后仍卡在FULLRESYNC
启用repl-diskless-sync yes本意是跳过RDB落盘,直接socket传输,加快全量同步速度。但它不解决“为什么总要全量”的问题。如果底层还是因上述原因不断触发FULLRESYNC,那只是把慢的全量变得更“快一点”,掩盖了根本症结。
- 确认是否真启用了:主库
config get repl-diskless-sync返回yes - 注意依赖:需Linux内核支持
SOCK_STREAM和sendfile,某些容器环境(如旧版Docker)可能不兼容 - 真正该先盯住的,是
INFO replication里master_repl_offset和slave_repl_offset的差值,以及repl_backlog_active是否为1
最易被忽略的点是:FULLRESYNC本身不是错误,而是PSYNC协议的正常降级行为;但频繁发生说明主从链路稳定性或缓冲区容量存在硬伤。别急着调优网络或换机器,先看repl-backlog-size和master_replid是否对得上——这两个参数不动,其他优化都是隔靴搔痒。


















