Pymongo SRV连接MongoDB报DNS查询名称不存在错误排查

该报错是使用mongodb+srv协议连接Mongo集群时，客户端无法通过DNS查询到集群对应的SRV记录导致，和Python版本、依赖版本、业务代码逻辑无直接关联。同一份代码同事设备可正常运行、你的设备复现问题，故障点集中在本地DNS解析链路、连接参数配置两个维度。

排查步骤（按优先级从高到低） #

1. 先验证本地DNS基础解析能力 #

先跳过代码层面排查，直接在本地命令行执行查询命令，验证是否能拿到目标SRV记录：

# Windows/Mac/Linux通用
nslookup -type=SRV _mongodb._tcp.stage.xxxx.mongodb.net

• 如果返回NXDOMAIN（记录不存在）结果，说明本地网络到公网DNS的链路确实无法获取该解析记录，问题和pymongo无关，走第二步排查
• 如果能正常返回多条包含优先级、权重、端口、集群节点地址的SRV记录，说明DNS解析本身没问题，直接走第三步排查

2. 修复DNS解析链路 #

你之前切换Google公共DNS未生效，按以下顺序排查：

• 第一优先级测试：临时关闭本地所有代理、VPN、企业安全客户端、广告拦截类网络工具，直接连接手机蜂窝热点重新运行项目。90%以上的同类报错都是运营商DNS劫持、代理工具篡改DNS请求导致，Comcast等海外运营商的默认DNS对MongoDB Atlas的SRV记录解析兼容性很差。
• 如果连热点能正常启动项目，说明原网络环境存在DNS污染：不要只修改网卡DNS配置，同时检查本地hosts文件是否有无关篡改、路由器是否配置了错误的DNS转发规则、系统网络设置里的「搜索域」列表是否有无关域名（你最早的报错里出现的mongodb.net.xxxx.com、comcast.net后缀，就是解析失败后自动拼接本地搜索域导致的，直接删掉这些无关搜索域即可）。修改DNS后必须清空本地DNS缓存：
  • Windows执行：ipconfig /flushdns
  • Mac执行：sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
  • Linux执行：sudo systemd-resolve --flush-caches

3. 绕开SRV解析快速修复（应急可用） #

如果网络环境短时间无法调整，直接放弃mongodb+srv协议，改用普通mongodb协议直连集群节点，完全跳过SRV解析步骤：

1. 从MongoDB集群管理后台复制所有集群节点的直连地址
2. 修改连接串格式，示例如下：

_uri = "mongodb://{username}:{password}@node1.stage.xxxx.mongodb.net:27017,node2.stage.xxxx.mongodb.net:27017,node3.stage.xxxx.mongodb.net:27017/{db}?authSource=admin&replicaSet={replica_set}&readPreference=primary&connectTimeoutMS={timeout}&authMechanism=SCRAM-SHA-1&ssl=true"

注意：

• 直连模式必须带上ssl=true参数，MongoDB Atlas集群强制要求TLS连接
• 该方案不需要依赖dnspython库做SRV记录查询，只要本地网络能连通集群节点的27017端口即可正常连接

4. pymongo配置兼容调整 #

如果不想修改连接串格式，初始化MongoClient时补充配置参数，避免解析逻辑异常：

self.client = MongoClient(
    _uri,
    connect=True,
    serverSelectionTimeoutMS=5000
)

另外你代码里的字符串格式化存在遗漏：format参数里没有传入maxPoolSize对应的值，这个问题虽然不会触发DNS报错，但会导致连接池配置不生效，记得补上对应参数。

注意：pymongo 3.12.0兼容的dnspython版本范围是1.16.0~2.3.0，你安装的2.2.1属于兼容版本，不需要回退dnspython版本。

内容的提问来源于stack exchange，提问作者Masterstack8080