“dns lookup failed”本质是域名解析失败，驱动未进入端口连接阶段；常见于连接串使用localhost等主机名时因ipv6/ipv4不匹配、srv记录缺失或directconnection=true但dns未配置导致。
“DNS lookup failed” 错误本质是解析失败，不是 MongoDB 拒绝连接
这个错误出现在 MongoClient 初始化或 .connect() 时，说明驱动根本没走到“尝试连 27017 端口”的阶段——它卡在了域名解析环节。常见于连接串里用了 localhost、mongo.example.com 这类主机名，而系统 DNS 或 hosts 配置异常，或 MongoDB 服务压根没监听对应地址。
检查连接串是否包含查询参数，关键在于：某些参数（比如 srv、directConnection）会强制改变解析行为，但若配置矛盾，就会触发看似“DNS 失败”的底层报错。
连接串中 localhost vs 127.0.0.1 导致的 DNS 解析差异
Node.js v17+ 默认启用 IPv6 DNS 解析，localhost 在大多数系统里会被解析成 ::1（IPv6 回环），而默认安装的 MongoDB 只监听 127.0.0.1（IPv4）。结果就是：驱动拼命查 ::1:27017，但 MongoDB 根本不响应，最终抛出类似 MongoServerSelectionError: DNS lookup failed 或更底层的 getaddrinfo ENOTFOUND。
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- ✅ 直接改连接串：把
mongodb://localhost:27017/dbname换成mongodb://127.0.0.1:27017/dbname - ✅ 或显式禁用 IPv6 解析：在
new MongoClient(uri, { family: 4 })中加family: 4选项 - ❌ 不要依赖
localhost做本地开发，尤其在 Windows 或 macOS 上，hosts 文件或 DNS 设置容易干扰
srv 查询参数开启后未正确配置 SRV 记录
如果连接串带 ?srv=true（如 Atlas 免费集群常用格式：mongodb+srv://user:pass@cluster.mongodb.net），驱动会先发起 DNS SRV 查询，找 _mongodb._tcp.cluster.mongodb.net 对应的记录。一旦 DNS 服务器没返回有效 SRV 条目，就会立刻报 DNS lookup failed，且不会 fallback 到普通 A 记录。
- ✅ 确认你用的是真实 Atlas 链接，且域名拼写完全一致（大小写、连字符、后缀都不能错）
- ✅ 本地测试时不要手动生成带
srv=true的串——除非你真配好了自己的 SRV 记录 - ❌ 不要对本地
mongod实例加?srv=true，它不支持 SRV 发现
directConnection=true 与 DNS 解析的隐含冲突
directConnection=true 表示跳过拓扑发现，直连指定 host:port。但它**不绕过 DNS 解析**——驱动仍需先把 host 名字转成 IP。所以如果你写了 mongodb://my-mongo-server:27017/?directConnection=true，而 my-mongo-server 在本地 hosts 里没定义，照样报 DNS 失败。
- ✅ 开发环境优先用
127.0.0.1或明确 IP，避免任何 host 解析依赖 - ✅ Docker 场景下，确保容器间通过服务名通信时，该服务名已在同一网络内被 DNS 正确注册（如 docker-compose 默认网络）
- ❌ 不要以为加了
directConnection=true就能无视 DNS 配置
真正卡住的往往不是 MongoDB 本身，而是那一层看不见的 DNS 查找——它失败时既不超时也不重试，就直接抛错。验证方式很简单：在终端运行 nslookup your-hostname 或 dig your-hostname，看是否能拿到 IP。拿不到，驱动就永远过不去第一关。
