MongoDB副本集从节点未同步数据的可能原因排查

以下是导致主节点写入未同步至从节点的常见原因及排查方向：

• 网络连通性中断
  主从节点之间的TCP连接被阻断是最常见的同步失败诱因。可能是防火墙规则更新、网络设备故障、默认端口（27017）被封禁，或是跨机房网络波动导致连接中断。
  排查：用ping <从节点IP>测试网络可达性，在主节点执行mongo --host <从节点地址>验证MongoDB服务连通性；查看主节点日志中是否存在NetworkInterfaceExceededTimeLimit、Failed to connect to secondary这类网络错误日志。

• 从节点状态异常
  从节点未处于正常的SECONDARY状态，无法参与同步。可能处于RECOVERING（正在恢复）、STARTUP2（初始化中）、ARBITER（被误设为仲裁节点）或DOWN状态。
  排查：在任意节点执行rs.status()，查看从节点的stateStr字段；若处于RECOVERING，检查日志是否有数据修复、索引重建的相关记录。

• 从节点复制延迟过大或oplog覆盖
  从节点性能不足（CPU、磁盘IO瓶颈）导致同步速度跟不上主节点写入速度，或主节点oplog容量过小，旧的oplog被滚动覆盖，从节点无法追上同步进度。
  排查：执行rs.printSlaveReplicationInfo()查看从节点的同步延迟时间和oplog窗口；用db.serverStatus().globalLock、db.serverStatus().diskIO检查从节点资源占用情况。

• 主节点写入未要求多数确认
  客户端写入时使用了w:1（仅确认主节点写入成功）的写关注级别，主节点完成写入后未等待同步至从节点就返回成功，若此时从节点同步链路中断，会出现数据不一致。
  排查：检查客户端写入代码的写关注配置，是否未设置w:majority；查看主节点日志中write concern相关的记录。

• 从节点复制进程故障
  从节点的同步线程（replSetSyncThread）因错误终止或卡住，比如遇到数据损坏、索引冲突、磁盘空间不足等问题。
  排查：查看从节点日志，搜索Sync error、replSet syncing to、Out of disk space这类关键词；执行db.serverStatus().diskSpace检查磁盘剩余空间。

• 副本集配置被误修改
  副本集配置变更（如从节点被移出members列表、priority被设为0、hidden属性被开启）导致从节点无法参与同步。
  排查：执行rs.conf()查看副本集成员配置，确认从节点存在且state为2（SECONDARY）。

• 权限或认证问题
  从节点用于同步的账号权限被撤销，或SSL/TLS证书过期，导致无法从主节点拉取oplog。
  排查：查看从节点日志中是否有Unauthorized、SSL handshake failed这类认证错误；验证复制账号的read权限是否包含local数据库。

• 数据冲突触发回滚
  从节点被意外写入数据（如手动开启secondaryWrite权限后写入），导致与主节点数据冲突，触发回滚操作，回滚期间同步暂停。
  排查：查看从节点的rollback目录（默认在数据目录下），或日志中Rollback相关记录。

内容的提问来源于stack exchange，提问作者Amandeep kaur