PAYATHON 2026

如何解决 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 配置

长期使用时,建议优先修复运行环境的配置:

  1. 在实际联网的网卡上配置已验证可用的 DNS。
  2. 检查 VPN、虚拟网卡是否覆盖了该配置。
  3. 如果应用运行在容器或 WSL 中,检查对应环境内的 DNS。
  4. 重启应用进程;必要时重启启动应用的 IDE 或进程管理器。
  5. 在没有 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 或必要网段,避免长期允许任意来源访问。

备注:内容仅供参考。