如何解决 MongoDb 连接时的 querySrv ECONNREFUSED 错误?
querySrv ECONNREFUSED 表示 MongoDB 连接时的 DNS SRV 查询失败。如果调用 dns.setServers() 后就能连接,应先检查 Node.js 使用的 DNS 服务器,以及访问这些服务器的网络路径。
要避免逐个修改项目源码,首选办法是修复应用运行环境的 DNS 配置。暂时无法修复时,可以通过共享预加载脚本统一设置 DNS。
为什么 Atlas 已允许所有 IP,仍然连接失败?
如果 MONGO_URL 使用 mongodb+srv://,驱动需要先查询 DNS,获取数据库节点。例如:
mongodb+srv://user:password@cluster0.example.mongodb.net/mydb
对应的 SRV 查询名称为:
_mongodb._tcp.cluster0.example.mongodb.net
驱动通过 SRV 记录发现节点,还可能读取 TXT 记录中的连接选项,然后才连接数据库。querySrv 错误发生在 DNS 查询阶段,不能据此认定 Atlas 的数据库端口拒绝了连接。MongoDB 连接字符串说明
Atlas 的 0.0.0.0/0 只影响数据库连接的 IP 访问限制,无法解决 DNS 查询失败的问题。本地安装 MongoDB 也不会改变 Atlas 连接字符串的解析过程。
为什么修改系统 DNS 无效,代码里设置却有效?
Node.js 的两类解析 API 使用不同的解析路径:
dns.lookup()使用操作系统提供的名称解析机制。dns.resolveSrv()、dns.resolveTxt()等方法直接向 DNS 服务器发送查询。
dns.setServers() 设置的是当前进程中 dns.resolve*() 等方法使用的 DNS 服务器。它不会修改系统 DNS,也不影响 dns.lookup()。Node.js DNS 文档
加入以下代码后连接成功,说明使用这组 DNS 时,连接所需的查询能够完成:
import dns from "node:dns/promises";
dns.setServers(["1.1.1.1", "1.0.0.1"]);
仅凭这个结果,还无法判断 Google DNS 或某个 Node.js 版本是否有问题。可以检查以下情况:
- 修改 DNS 后,应用进程尚未重启。
- 修改的是其他网卡,当前连接实际经过 VPN 或虚拟网卡。
- 应用运行在 Docker、WSL 或远程服务器中,使用独立的 DNS 配置。
- 路由器、本地 DNS 转发服务或防火墙影响了查询。
浏览器能打开网站,也不能证明 Node.js 的 SRV 查询正常。
先检查 Node.js 实际使用的 DNS
在应用所在的运行环境中执行:
node -e "console.log(require('node:dns').getServers())"
这条命令会输出当前 Node.js 解析器配置的 DNS 服务器地址。dns.getServers() 文档
如果输出的是本地回环地址或路由器地址,说明查询会先经过本地或局域网转发服务。这不一定是配置错误,还需要验证它能否解析 SRV 记录。
接着,用独立脚本比较默认 DNS、Google DNS 和 Cloudflare DNS。将示例域名替换为 MONGO_URL 中 @ 后、/ 前的集群主机名,不要填入用户名和密码。
// check-dns.mjs
import dns, { Resolver } from "node:dns/promises";
const hostname = "cluster0.example.mongodb.net";
const srvName = `_mongodb._tcp.${hostname}`;
async function check(label, resolver) {
try {
console.log(label, await resolver.resolveSrv(srvName));
} catch (error) {
console.error(label, {
code: error.code,
syscall: error.syscall,
hostname: error.hostname,
});
}
}
console.log("Default DNS servers:", dns.getServers());
await check("Default DNS", dns);
for (const server of ["8.8.8.8", "1.1.1.1"]) {
const resolver = new Resolver();
resolver.setServers([server]);
await check(server, resolver);
}
运行:
node check-dns.mjs
脚本使用独立的 Resolver 做对照,不会改动其他解析器的设置。Resolver 文档
如果只有默认 DNS 失败,重点检查默认解析路径。如果 8.8.8.8 失败而 1.1.1.1 成功,应检查当前网络访问这两个 DNS 服务时有何差异。若 SRV 查询成功后应用仍无法连接,再检查 TXT 查询、节点域名解析和数据库连接错误。
无需逐个修改项目的解决方法
方法一:修复运行环境的 DNS 配置
长期使用时,建议优先修复运行环境的配置:
- 在实际联网的网卡上配置已验证可用的 DNS。
- 检查 VPN、虚拟网卡是否覆盖了该配置。
- 如果应用运行在容器或 WSL 中,检查对应环境内的 DNS。
- 重启应用进程;必要时重启启动应用的 IDE 或进程管理器。
- 在没有
dns.setServers()覆盖的情况下,重新运行上述诊断脚本。
修改系统设置后,以应用运行环境中的实际查询结果为准。MongoDB 官方也将更换支持 SRV 查询的 DNS 列为此类错误的解决办法。Atlas 连接故障排查
如果使用企业内网域名或 Atlas 私有端点,应使用能解析这些域名的内部 DNS,并由网络管理员修复转发配置。公共 DNS 不一定适用。
方法二:通过 NODE_OPTIONS 统一预加载
暂时无法修复系统配置时,可以维护一份共享脚本,通过启动环境加载。
创建共享文件 dns-bootstrap.cjs:
const dns = require("node:dns");
dns.setServers(["1.1.1.1", "1.0.0.1"]);
在 macOS 或 Linux 的 shell 中设置:
export NODE_OPTIONS='--require "/absolute/path/dns-bootstrap.cjs"'
Windows PowerShell 示例:
$env:NODE_OPTIONS = '--require "C:\tools\dns-bootstrap.cjs"'
将路径替换为实际的绝对路径,然后按原来的方式启动项目。Node.js 会在应用入口运行前加载该文件,ES module 项目也可以使用这个 .cjs 预加载脚本。Node.js --require 与 NODE_OPTIONS 文档
这种方式无需修改每个项目的源码,使用时需注意:
- 只有继承了该环境变量的新 Node.js 进程才会生效。
- 若已有
NODE_OPTIONS,应保留原有选项并追加--require。 - 全局设置会影响该环境下的其他 Node.js 工具,最好限定在需要它的开发或服务环境中。
- 不要仅将它写进由
dotenv.config()加载的项目.env,因为预加载发生在应用代码执行之前。
方法三:改用 Atlas 提供的非 SRV 连接字符串
如果环境中的 SRV 查询持续不可用,可以在 Atlas 连接界面获取标准的 mongodb:// 连接字符串,用它替换 MONGO_URL。原有的 mongoose.connect(MONGO) 可以保留。Atlas 故障排查说明
不要只删除原地址中的 +srv。标准连接字符串需要正确的节点列表和连接选项,应完整采用 Atlas 提供的内容,保留 TLS、认证和副本集等必要设置。
这种方式会绕过 SRV/TXT 服务发现,但节点主机名通常仍需要 DNS 解析。
其他注意事项
如果同一网络下,不同 Node.js 版本的诊断结果不同,可以进一步检查运行时差异。对照时,应选择项目支持且仍在维护的版本。仅凭这个错误,无法认定 Node.js 24 或 Mongoose 9 存在问题。
原问题第二段代码中的两处日志缺少反引号,复制使用前需要修正:
console.error(`MongoDb Connection failed : ${error}`);
console.log(`Server started on port Number : 5000`);
排查时也可以直接输出错误对象,保留错误码和查询名称:
.catch((error) => {
console.error("MongoDB connection failed:", error);
});
DNS 修复后,应将 Atlas 的 0.0.0.0/0 收紧为应用实际使用的出口 IP 或必要网段,避免长期允许任意来源访问。
备注:内容仅供参考。
