启动Node服务连接MongoDB时报querySrv ETIMEOUT超时错误如何解决

querySrv ETIMEOUT 报错的核心是Node.js进程在查询MongoDB Atlas集群的SRV DNS记录时超时，绝大多数场景不是代码配置遗漏，属于网络/DNS/访问规则类外部问题。

• 第一步先验证DNS解析是否正常
  在终端执行命令：

  nslookup _mongodb._tcp.cluster0.pinlk.mongodb.net
  

  如果命令返回查询超时、域名不存在，说明是DNS层面阻断：
  • 优先检查本地网络是否存在域名限制：公司/校园网常存在公网域名访问限制，本地开启的代理/VPN未正确接管Node.js进程的DNS请求也会触发该问题，可临时切换手机热点、更换公共DNS（114.114.114.114、223.5.5.5）、调整代理规则后重试。
• 第二步核对连接串配置正确性
  • 确认复制的Atlas连接串无多余字符、缺漏，标准SRV连接串格式为mongodb+srv://<用户名>:<URL编码后的密码>@cluster0.pinlk.mongodb.net/<目标库名>，注意密码如果包含@、/、:这类特殊字符必须做URL编码，否则会干扰解析逻辑。
  • 如果多次调整DNS仍解析失败，可直接在Atlas控制台切换为非SRV格式的普通连接串，跳过SRV记录查询步骤直接连接集群节点。
• 第三步核对Atlas侧访问规则
  登录MongoDB Atlas控制台检查两项配置：
  • 进入「网络访问」页，确认当前设备的出口公网IP已经加入IP白名单，临时调试可先添加0.0.0.0/0放开所有IP验证连通性（生产环境禁止该配置）。
  • 确认集群未处于休眠、维护状态，免费层集群长时间无访问会自动休眠，首次唤醒需要1-2分钟等待时间。

写最小测试脚本排除业务代码干扰，脚本内容如下：

const { MongoClient } = require('mongodb');
// 替换为自己的正确连接串
const uri = "替换为你的MongoDB连接串";
const client = new MongoClient(uri);
async function testConn() {
  try {
    await client.connect();
    await client.db("admin").command({ ping: 1 });
    console.log("数据库连接成功");
  } finally {
    await client.close();
  }
}
testConn().catch(console.error);

• 如果该脚本运行成功，说明故障来自业务代码逻辑，常见问题是读取了错误的环境变量、数据库初始化时机不对。
• 如果该脚本仍报相同的超时错误，可完全排除代码问题，继续排查网络层面即可。

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