必须添加replicaSet参数并提供所有种子节点地址,否则MongoDB驱动退化为单机模式,无法感知副本集拓扑、触发故障转移;集群需满足法定多数(如3节点需至少2健康节点)才能选举PRIMARY。

连接字符串缺 replicaSet 参数导致驱动不识别副本集
客户端用 mongodb://192.168.1.10:27017 这种单地址连接,哪怕后端是三节点副本集,驱动也当单机用——它压根不会发心跳、查拓扑、感知主从变化。结果就是:rs.status() 显示有 PRIMARY,但应用连的其实是某个 SECONDARY,一写就报 NotMaster。
必须把所有种子节点(至少一个能连通的)和 replicaSet 参数带上:
mongodb://node1:27017,node2:27017,node3:27017/?replicaSet=rs0&readPreference=primary
- 缺
replicaSet=rs0→ 驱动退化为单节点模式,readPreference对写无效 - 只写一个 IP → 无法触发自动发现,故障转移完全失效
- Kubernetes 中用 Headless Service 直连 Pod IP,也会绕过 replicaSet 协议层
集群未形成法定多数,选举被阻断
三个节点的副本集,只要两个失联(health: 0 或 lastHeartbeatRecv 停滞),剩下那个即使健康,也无法选出 PRIMARY——因为法定人数是 ⌊3/2⌋+1 = 2,而它自己只有 1 票。
检查真实健康节点数,别只数进程是否在跑:
rs.status().members.filter(m => m.health === 1 && m.stateStr !== "ARBITER")
- 状态为
RECOVERING、STARTUP2的节点不参与投票 - 仲裁节点(
arbiterOnly: true)只投票,不存数据,不能升主 - 网络分区时,各边可能各自认为自己是 majority,但只有一边能完成
w: "majority"写入
客户端连到了被冻结或低优先级的 Secondary 节点
有人为维护执行过 rs.freeze(3600),或把某节点 priority 设为 0,又没改回来。这时它永远无法参选,而其他节点若因同步延迟、长事务卡住,就可能出现“有节点但选不出主”的假死状态。
- 在 PRIMARY 上运行
rs.conf(),确认所有健康节点的priority >= 1且votes: 1 - 检查是否有节点被
rs.freeze()锁住:看rs.status().members[n].stateStr是否为FROZEN - 避免在部署脚本里硬编码
--host sec-node-01,这种直连必绕过选举逻辑
容器或云环境绕过了副本集发现机制
在 Kubernetes 里用 ClusterIP Service + DNS SRV 记录,但连接串没加 srvServiceName;或者用负载均衡器做四层转发,把所有流量打到固定后端——这两种情况,驱动收不到完整的拓扑信息,等同于单地址连接。
- SRV 模式必须带
mongodb+srv://前缀和srvServiceName参数 - 云数据库(如 Atlas)控制台生成的连接串,要核对是否含
replicaSet和ssl=true(SSL 不启用会导致握手失败,间接表现为连不上主) - Prometheus MongoDB Exporter 若部署在 secondary 容器里,默认直连本地,健康检查写入必然失败
真正卡住的往往不是配置本身,而是环境层悄悄替你关掉了副本集协议——比如 Service 的 endpoint 列表只包含一个 IP,或者 DNS 解析只返回一个 A 记录。这种问题在测试环境能过,上线后突然崩,最难排查。











