Express应用连接MongoDB Atlas出现queryTxt ETIMEOUT错误求助

问题详情 #

我正在尝试把一个简易Express服务器连接到MongoDB Atlas，已经创建了项目、数据库和集群，严格按照官方提供的连接字符串配置，但几分钟后出现了错误。

代码示例 #

import express from "express";
import mongoose from "mongoose";

mongoose
  .connect(
    "mongodb+srv://carproject:carproject1@car-project.u4g8sog.mongodb.net/?retryWrites=true&w=majority&appName=car-project"
  )
  .then(() => {
    console.log("connected");
  }).catch(err=> 
  {
    console.log(err)
  }
    )

const app = express();
app.get("/", (req, res) => {
  res.send("Hello, World!!!");
});

const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {
  console.log(`Server is running on port ${PORT}`);
});

报错信息 #

Error: queryTxt ETIMEOUT car-project.u4g8sog.mongodb.net
    at QueryReqWrap.onresolve [as oncomplete] (node:internal/dns/promises:251:17) {
  errno: undefined,
  code: 'ETIMEOUT',
  syscall: 'queryTxt',
  hostname: 'car-project.u4g8sog.mongodb.net'
}

解决方案 #

• 排查DNS解析与网络问题
  这个错误本质是DNS查询超时，先在终端执行nslookup car-project.u4g8sog.mongodb.net或dig car-project.u4g8sog.mongodb.net，确认域名能否正常解析。如果无法解析，切换本地DNS服务器（比如谷歌8.8.8.8或Cloudflare 1.1.1.1），同时检查防火墙、代理是否拦截了DNS请求。

• 验证MongoDB Atlas IP白名单
  登录Atlas控制台，进入目标集群的Network Access页面：

  • 确认已添加当前机器的公网IP
  • 测试环境可临时设置为0.0.0.0/0（允许所有IP访问，生产环境禁止）
  • 保存设置后等待1-2分钟再测试连接

• 核对连接字符串准确性
  重新从Atlas控制台复制连接字符串，重点检查：

  • 用户名、密码是否正确（密码含特殊字符需做URL编码）
  • 集群地址car-project.u4g8sog.mongodb.net无拼写错误
  • 可先简化连接字符串测试，去掉非必要参数：mongodb+srv://carproject:carproject1@car-project.u4g8sog.mongodb.net/

• 检查依赖版本兼容性
  确保mongoose版本与MongoDB Atlas服务器版本兼容，执行npm update mongoose更新到最新稳定版后重试。

• 用MongoDB Shell测试连接
  使用Atlas提供的mongosh命令直接测试：

  mongosh "mongodb+srv://car-project.u4g8sog.mongodb.net/?retryWrites=true&w=majority&appName=car-project" --username carproject
  

  如果shell连接失败，问题出在网络或Atlas配置；如果shell能连接，再排查mongoose的配置细节。

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