NestJS连接MongoDB Atlas遇querySrv ECONNREFUSED，手动设DNS可解决

在将NestJS/Express应用连接MongoDB Atlas时，反复出现以下错误：

Error: querySrv ECONNREFUSED _mongodb._tcp.<cluster-name>.mongodb.net

同时NestJS持续重试连接：

[Nest] ERROR [MongooseModule] Unable to connect to the database. Retrying (1)...
[Nest] ERROR [MongooseModule] Unable to connect to the database. Retrying (2)...
[Nest] ERROR [MongooseModule] Unable to connect to the database. Retrying (3)...

已完成的排查步骤：

• 确认MongoDB Atlas集群处于运行状态
• IP白名单已配置为0.0.0.0/0
• 连接字符串正确
• 账号凭据有效
• 重启过服务器

在main.ts顶部添加以下代码后，连接恢复正常：

import { setServers } from 'node:dns';

setServers(['1.1.1.1', '8.8.8.8']);

特殊情况：

• 仅在NestJS应用中出现该问题，相同连接字符串可在MongoDB Compass和普通Node.js脚本中正常使用
• 仅手动指定DNS服务器后问题解决

1. 为什么设置DNS服务器可以解决该问题？ #

MongoDB Atlas的SRV格式连接字符串，需要DNS服务器能正确解析_mongodb._tcp.<cluster-name>.mongodb.net这条SRV记录，以此获取集群的实际节点地址和端口。

你的情况里，NestJS应用默认使用的DNS服务器（大概率是系统默认DNS）无法完成这个SRV解析请求——可能是该DNS服务器不支持SRV记录查询、网络访问被拦截（比如防火墙限制UDP 53端口），或者解析超时。而手动指定的1.1.1.1（Cloudflare DNS）和8.8.8.8（Google公共DNS）是专门优化过的公共DNS服务，能稳定解析MongoDB Atlas的SRV记录，所以连接成功。

另外，普通Node脚本和Compass能正常连接，说明它们的DNS解析逻辑或使用的DNS配置和NestJS应用存在差异——比如NestJS的Mongoose模块初始化时机更早，此时系统DNS配置还没完全加载；或者Windows环境下，NestJS进程的网络上下文没有正确继承系统DNS设置。

2. 这是正规解决方案还是仅为临时workaround？ #

这取决于问题的根本原因：

• 如果是系统/网络环境的DNS配置问题（比如公司网络DNS限制、本地DNS损坏），手动指定公共DNS可以作为长期解决方案，但建议不要硬编码在代码里，而是通过系统环境变量（比如NODE_OPTIONS=--dns-servers=1.1.1.1,8.8.8.8）或者NestJS的配置文件来管理，更灵活。
• 如果是NestJS/Mongoose的特定兼容性问题（比如模块加载时的DNS初始化bug），这属于临时workaround，需要关注NestJS或Mongoose的后续版本修复。

从你的特殊情况来看，更可能是前者（DNS环境问题），所以这个方案是合理的，可作为长期方案使用，只要公共DNS服务稳定可用。

3. querySrv ECONNREFUSED错误的根本原因是什么？ #

这个错误的核心是：Node.js的DNS模块尝试查询SRV记录时，无法连接到指定的DNS服务器，连接被拒绝（ECONNREFUSED）。

具体到你的场景，可能的原因包括：

• 系统默认DNS服务器不可达，或者端口（UDP 53）被防火墙/网络策略拦截
• 系统默认DNS服务器不支持SRV类型的DNS查询
• NestJS应用的运行上下文没有正确获取系统DNS配置，导致使用了无效的DNS服务器

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