mongoclient连接副本集必须列出所有可投票数据节点地址并指定正确replicaset参数，否则故障转移后连接中断；仲裁节点不可加入连接字符串，且需显式配置超时、读偏好并验证主节点连通性。
MongoClient 连接副本集时，必须用连接字符串指定全部成员地址，不能只写一个节点——否则故障转移后连接会直接中断。
连接字符串必须包含全部可投票节点
副本集不是“主库地址+自动发现”，而是靠客户端主动解析所有成员并监听状态变化。如果只写 "mongodb://192.168.56.101:10101/"，一旦该节点降级为 SECONDARY 或宕机，MongoClient 不会自动切到其他节点，反而持续重试失败。
- 正确写法：把所有数据节点（不含仲裁节点）都列进连接字符串，例如：
"mongodb://192.168.56.101:10101,192.168.56.101:20101/?replicaSet=test" - 仲裁节点（
arbiterOnly:true）不要加入连接字符串——它不存数据，也不参与读写，加进去反而增加无效心跳开销 -
replicaSet参数名必须与初始化时的_id完全一致（大小写敏感），比如db.runCommand({"replSetInitiate": {"_id": "test", ...}})，这里就必须用?replicaSet=test
超时和重试参数要显式设好
默认连接行为在副本集场景下容易卡住或报错，尤其在网络波动或主从切换期间。
Claw Code Suite (Python-Only Edition)
下载
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
-
serverSelectionTimeoutMS=3000：控制“选不到可用服务器”时的等待上限，设太大会阻塞应用；设太小可能误判（比如刚切换完还没同步完状态） -
connectTimeoutMS=5000：单次 TCP 连接尝试上限，避免因某个节点彻底不可达而拖慢整个连接过程 -
socketTimeoutMS=30000：读写操作级超时，防止慢查询或网络抖动导致线程挂起 - 建议加上
minPoolSize=5和maxPoolSize=10，避免副本集内节点数变化时连接池震荡
连接后务必验证是否真正连上 PRIMARY
成功创建 MongoClient 实例 ≠ 已连上可写节点。常见错误是代码没报错，但后续 insert_one() 直接抛 NotPrimaryError。
- 用
client.admin.command("ping")只能确认“连得通”，不能确认“能写” - 可靠方式是执行一次写操作并捕获异常：
try: client.test.test_collection.insert_one({"x": 1}, bypass_document_validation=True) except NotPrimaryError: print("当前没连上 PRIMARY") - 更轻量的做法是查
client.admin.command("isMaster")["ismaster"]—— 返回True才代表当前 socket 连的是 PRIMARY
分片 + 副本集混合部署时别混用 mongos 和 replicaSet
你知识库里提到用 mongos 做路由，这是针对分片集群的；而副本集本身不需要 mongos。如果误把副本集当分片集群连："mongodb://192.168.56.1:27017/?replicaSet=test"（却指向了 mongos 进程），会报 ServerSelectionTimeoutError 或静默失败。
- 确认目标服务类型：
副本集 → 直连任意一个mongod（带replicaSet参数）
分片集群 → 连mongos（不带replicaSet，但可加maxStalenessSeconds） - Windows 上跑的
mongos和 Linux 上的mongod副本集是两套独立服务，不能共用同一套连接逻辑 - 如果真需要统一接入层，应该让应用只连
mongos，而把副本集作为底层分片的 shard，而不是让 Python 客户端直连副本集再额外加一层mongos
readPreference 就直接读，结果发现写不了、某些聚合报错、或者 insert 随机失败——这些都不是网络问题，而是连接语义没对齐。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
