pymongo连接副本集必须在uri中列出全部节点并指定replicaset参数，且需显式设置directconnection=false，否则无法实现高可用；验证须调用ismaster命令检查ismaster、hosts和setname等字段。
PyMongo连接副本集时URI必须包含全部节点地址
只写一个节点地址无法实现高可用，PyMongo在初始化时会主动探测整个副本集拓扑。如果URI里只填mongodb://localhost:27017，即使集群有3个节点，驱动也只会连这个地址，故障时不会自动切换。
正确做法是把所有可访问的副本集成员都列进URI，用逗号分隔：
mongodb://node1:27017,node2:27017,node3:27017/?replicaSet=myReplSet
注意：replicaSet参数名必须与MongoDB配置中replSetName完全一致（区分大小写），否则连接成功但无法执行写操作，报错NotPrimaryNoSecondaryOk。
必须显式启用directConnection=False（Python 3.12 + PyMongo 4.6+）
PyMongo 4.6起默认启用directConnection=True，这会强制绕过副本集发现机制——哪怕你写了多个节点、配了replicaSet，它也只连第一个节点，当成单机用。
解决方法是在URI里加参数，或代码中显式传参：
- URI方式：
mongodb://node1:27017,node2:27017/?replicaSet=myReplSet&directConnection=false - 代码方式：
MongoClient(..., directConnection=False)
漏掉这个参数是Python 3.12下副本集连接失败最常见原因，错误现象是能连上、能读，但写操作随机抛ConnectionFailure或卡住。
验证是否真正接入副本集：检查client.admin.command("isMaster")返回
别只看client.server_info()返回不报错就认为OK。必须调用isMaster确认角色和拓扑：
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
result = client.admin.command("isMaster")
关键字段检查项：
-
"ismaster"为True→ 当前连接的是Primary -
"hosts"数组长度 ≥ 3 → 驱动已发现全部节点 -
"setName"值与配置一致 → 副本集名称匹配 -
"passive"或"arbiterOnly"出现在"hosts"对应节点信息里 → 拓扑识别正常
如果"hosts"只有1个地址，说明directConnection仍为True或URI格式有误。
超时与重试配置影响故障转移速度
副本集主节点宕机后，新Primary选举通常需10–30秒。若PyMongo超时太短，应用会在选举完成前就报错断连。
建议组合设置以下参数：
-
serverSelectionTimeoutMS=30000：给足够时间等待新Primary上线 -
socketTimeoutMS=30000：避免网络抖动触发误判 -
retryWrites=True（默认开启）：写失败时自动重试到新Primary
不设serverSelectionTimeoutMS会导致默认5秒超时，多数情况下来不及等完选举，结果就是连续报ServerSelectionTimeoutError。
副本集连接真正的复杂点不在写法，而在验证——很多看似“连上了”的实例，其实只是连到了某个Secondary却没走复制集协议，这种状态在负载突增或主切时立刻暴露。每次部署后务必跑一遍isMaster检查。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
