“no primary found”错误主因是pymongo无法在seed list中识别出primary节点，而非网络不通；需确保seed地址与rs.conf().members[n].host完全一致、replicaset值匹配、dns可解析、primary节点置首、启用日志并验证rs.status()及ismaster响应。
PyMongo连接时提示“no primary found”根本不是网络不通
绝大多数情况，no primary found 错误和网络连通性无关，而是 PyMongo 在 seed list 里压根没识别出任何 PRIMARY 节点。它不会报“connection refused”，而是安静地遍历你给的地址列表，发现每个节点返回的 rs.status() 里都没标自己是主，就直接放弃。
- 用
mongosh连任一 seed 地址，执行rs.status()，确认stateStr确实有"PRIMARY"，且对应成员的name字段（比如"node1.example.com:27017"）能被你的 Python 进程 DNS 解析 - seed list 别写
localhost或127.0.0.1——Docker 容器里解析出来是自己，不是副本集节点 - PyMongo 的 seed 地址必须和
rs.conf().members[n].host完全一致：协议、端口、域名大小写、有无 trailing slash，一个字符都不能差 - 连接字符串中
replicaSet=xxx的值，必须原样复制自rs.conf()._id，大小写、空格、下划线都不能错
seed list顺序和数量直接影响连接成功率
PyMongo 不并发探测所有 seed，而是按顺序逐个握手。第一个超时或响应慢，就会卡住整个初始化过程，直到 timeout（默认 30 秒）后才试下一个——这期间应用就挂了。
- 把已知稳定的 PRIMARY 节点放在 seed list 最前面，哪怕它只是临时主
- 至少列 2–3 个成员地址，用英文逗号分隔：
"mongodb://node1:27017,node2:27017,node3:27017/?replicaSet=myrs" - 别只填一个 seed；也别混用 URI 和关键字参数，比如 URI 里写了
replicaSet=myrs，就不要再额外传replicaSet='myrs' - 启用详细日志：
pymongo.MongoClient(..., connect=False, serverSelectionTimeoutMS=5000)，然后第一次操作前加client.admin.command("isMaster")捕获真实错误
rs.status() 显示 PRIMARY ≠ 真能处理写入
网络分区后可能出现“双主假象”：两个节点都显示 stateStr: "PRIMARY"，但只有多数派那个能接受 w: "majority" 写入。少数派那个会拒绝所有 majority 写，并返回 NotMaster 或静默超时。
- 别信单个节点的
rs.status()——它只反映本节点视角。真正要查的是每个节点的optimes.lastCommittedOpTime，差距大的那个大概率是孤立主 - 应用层写操作前，必须显式执行轻量探测：
db.runCommand({ isMaster: 1 })，检查返回里的ismaster和hosts数量是否匹配预期（如应有 3 个 host，却只返回 1 个，极可能已被隔离） - PyMongo 驱动不会自动剔除假主。Node.js 驱动需设
directConnection=false+appName，Java 驱动要监听ServerDescriptionChangedEvent -
w: "majority"不等于“写成功”，还依赖writeConcernMajorityJournalDefault。若部分节点关了 journal，写入看似成功，崩溃后数据会回滚
副本集配置损坏导致 PRIMARY 消失怎么办
如果 rs.status() 显示所有节点都是 STARTUP2、RECOVERING 或 UNKNOWN，且反复重连都找不到主，大概率是 local.system.replset 配置损坏。这时候不能靠 rs.reconfig() 修复——它需要多数节点共识，单节点强制执行只会让集群彻底失联。
- 停掉所有节点，选一个干净节点，启动为单机模式（去掉
--replSet参数），连上去执行：db.system.replset.drop()→db.oplog.rs.drop() - 再用
rs.initiate()重建，必须传完整配置对象，不能空参：rs.initiate({_id:"myrs", members:[{_id:0,host:"node1:27017"},{_id:1,host:"node2:27017"}]}) - host 值必须是其他节点能解析的地址；每个
_id必须是不重复整数；首次初始化不支持priority、hidden等字段 - 修复后立刻验证：
rs.status().members[n].syncSourceHost是否已选定，stateStr是否逐步变为STARTUP2 → RECOVERING → SECONDARY
