根本原因是驱动未启用拓扑监控或DNS解析失败后fallback至静态地址：①未用mongodb+srv://协议；②DNS无法返回SRV/TXT记录；③驱动版本过低（Node.js＜4.0，PyMongo＜4.7）。
为什么 MongoClient 连不上 SRV 地址，或者连上了却不感知主节点变化
根本原因通常是驱动没启用拓扑监控（topology monitoring），或 DNS 解析失败后直接 fallback 到静态地址而不再刷新。MongoDB 官方驱动默认开启 srvMaxHosts 和 srvServiceName 相关逻辑，但前提是：① 使用 mongodb+srv:// 协议；② DNS 能正确返回 SRV + TXT 记录；③ 驱动版本 ≥ 4.0（Node.js）或 ≥ 4.7（Python PyMongo）。低于这些版本的驱动会静默忽略 SRV，转而尝试连接字符串里硬写的 host。
常见错误现象：ServerSelectionTimeoutError、TopologyDescriptionNotKnownError、日志里反复出现 “No suitable servers found” 却能 ping 通单个 mongod。
- 检查是否用了
mongodb+srv://开头 —— 写成mongodb://就完全绕过 SRV 解析 - 确认 DNS 可解析：运行
dig _mongodb._tcp.your-cluster.mongodb.net SRV和dig your-cluster.mongodb.net TXT，必须返回至少一条 SRV 记录和一条包含service= mongodb的 TXT 记录 - PyMongo 用户注意：
directConnection=True会强制关闭拓扑发现，SRV 失效；Node.js 用户避免在connect()时传入directConnection: true
如何验证驱动是否真正在监听拓扑变化
拓扑监控不是“连上就完事”，而是持续轮询 isMaster 命令并响应 hello 结果里的 ismaster、secondary、hosts 字段。如果应用长期没发任何命令，部分驱动（如旧版 Java）可能暂停心跳，导致主备切换后数秒内仍往旧主发请求。
实操建议：
- 打开驱动日志：Node.js 加
monitorCommands: true和heartbeatFrequencyMS: 5000；PyMongo 设logging.getLogger("pymongo").setLevel(logging.DEBUG) - 手动触发一次主备切换（比如在 Atlas 控制台点击 “Rebalance” 或 kill 主节点），观察日志中是否出现
TopologyDescriptionChangedEvent或类似 “New server added: xxx:27017” - 不要依赖
client.db().admin().command({ping: 1})来“保活”——它不触发拓扑刷新；真正有效的是发起一个真实读/写操作（哪怕db.collection.find_one({})）
SRV 解析失败时的 fallback 行为与风险
当 DNS 解析失败（如超时、NXDOMAIN、无 SRV 记录），不同语言驱动行为不一致：Node.js 驱动会立即报错 MongoServerSelectionError: getaddrinfo ENOTFOUND；PyMongo 则可能 fallback 到 TXT 记录里指定的备用域名，或静默使用初始 SRV 查询返回的 IP 列表（如果之前缓存过）。
这带来两个隐藏问题：
- SRV 缓存时间（TTL）被系统 DNS 缓存覆盖，Linux 上
/etc/resolv.conf的options timeout:1可能让解析在 1 秒内失败，驱动来不及重试 - 某些云环境（如 AWS EKS）的 CoreDNS 默认禁用对公网 SRV 查询，需显式配置
forward . 8.8.8.8 - 避免在生产环境设置
srvMaxHosts=1—— 它会让驱动只取 SRV 返回的第一个 host，失去多节点容错能力
连接字符串里哪些参数会影响主备切换延迟
拓扑感知速度不只取决于网络，更由几个关键参数控制。它们共同决定“发现主挂了 → 找到新主 → 开始转发请求”的耗时。
-
heartbeatFrequencyMS：默认 10000（10 秒），即每 10 秒发一次hello。设太小（如 1000）会增加载；设太大（如 30000）会导致最长 30 秒才发现主失效 -
serverSelectionTimeoutMS：默认 30000，是“选主超时”，不是“切换超时”。它只影响 connect() 或首次查询前的等待，不影响运行中切换 -
localThresholdMS：默认 15，用于剔除延迟过高的节点。如果主备间 RTT 波动大（如跨可用区），设太小会导致健康节点被误判下线 - Java 用户额外注意：
minHeartbeatFrequencyMS必须 ≤heartbeatFrequencyMS，否则驱动启动失败，报错IllegalArgumentException
最易被忽略的一点：所有这些参数必须在初始化 MongoClient 时传入，运行时无法动态修改。改了配置不重启 client，等于没改。
