pymongo 连接单机 mongodb 时若误加 replicaset 参数，会强制启用副本集发现流程，而单机 mongod 未启用副本集模式，导致 ismaster 响应缺失 setname 字段，触发 serverselectiontimeouterror 报错。
PyMongo 连接单机 MongoDB 时如果误加了副本集参数（比如 replicaSet 或 rs），会直接报错或卡住，根本连不上——这不是配置问题，是驱动强制要求副本集协议握手，而单机 mongod 没启用副本集模式。
为什么加了 replicaSet 参数就会连不上
PyMongo 在检测到连接字符串含 replicaSet=xxx 时，会跳过普通直连逻辑，改走 replica set discovery 流程：它会尝试向目标节点发 isMaster 命令，并检查返回里的 hosts、setName 字段是否匹配。单机 mongod 的 isMaster 返回里没有 setName，或者 hosts 只有自己但没配 replicaSet 启动参数，PyMongo 就判定“这不是副本集”，然后抛出 ServerSelectionTimeoutError 或卡在重试。
- 典型错误信息：
ServerSelectionTimeoutError: No replica set members matching criteria - 即使 mongod 是本地
mongod --port 27017启动，只要连接串带replicaSet=xxx，就失败 -
MongoReplicaSetClient已废弃（PyMongo ≥ 3.0），现在统一用MongoClient，但它对replicaSet参数依然敏感
如何快速识别并删掉 rs 相关参数
检查你的连接字符串或 MongoClient 初始化参数，删掉所有和副本集相关的字段：
- 连接字符串中删掉
&replicaSet=xxx或?replicaSet=xxx - 如果用字典传参，确保没传
replicaSet、readPreference、maxStalenessSeconds等副本集专属选项 - 避免混用旧写法：比如
host="127.0.0.1:27017"+replicaSet="rs0"—— 单机场景下这两者互斥 - 正确单机写法只有两种：
MongoClient("mongodb://127.0.0.1:27017/")或MongoClient("127.0.0.1", 27017)
连接串里还有哪些参数会触发副本集行为
除了显式的 replicaSet，以下参数也会让 PyMongo 切换到副本集模式（哪怕只连一个地址）：
-
readPreference=xxx（如secondaryPreferred） maxStalenessSeconds-
localThresholdMS（虽然名字不明显，但它是副本集拓扑感知参数） - 连接字符串里多个 host 用逗号分隔，例如
"mongodb://a:27017,b:27017/"—— PyMongo 会默认按副本集解析，除非加?directConnection=true
如果你确实只连一台，最稳妥的写法是：MongoClient("mongodb://127.0.0.1:27017/?directConnection=true")，这个参数能明确告诉驱动“别猜，就是直连”。
删完参数后仍连不上？检查 mongod 是否真没启副本集
有时候你以为是单机，但 mongod 其实是以 --replSet 启动的（比如之前 init 过副本集，后来没清数据）。这时即使删了连接串参数，isMaster 返回里仍有 setName，PyMongo 仍会尝试走副本集逻辑。
- 进 mongo shell 执行
rs.status()，如果报no replset config或not master and slaveOk=false，说明副本集没初始化，安全 - 如果返回正常配置（哪怕只有一个成员），说明 mongod 是以副本集模式运行的，你得要么停掉它重启为单机模式（去掉
--replSet或配置文件里的replication.replSetName），要么接受它作为单成员副本集来连（此时必须保留replicaSet参数） - 清空副本集配置的终极操作是：进
local库执行db.system.replset.remove({})，再重启 mongod
真正容易被忽略的是：mongod 进程本身的状态比连接串更权威；删参数只是表象，确认服务端没开副本集才是根因。
