NodeJS连接MongoDB Atlas报ETIMEDOUT连接超时问题求助

MongoServerSelectionError: connect ETIMEDOUT 错误本质是客户端到Atlas数据库节点的网络链路未能连通，和账号权限、密码格式这类应用层配置无直接关联。你已完成的4项排查已经覆盖了最常见的基础配置问题，剩下按以下方向逐个验证即可定位问题：

排查方向1：验证本地到Atlas节点的端口连通性 #

• 打开Windows命令提示符，执行命令 telnet 157.241.16.152 27017：
  • 如果提示连接超时，说明本地到Atlas节点的27017端口被拦截
  • 如果弹出空白黑框，说明端口连通正常，问题出在驱动配置侧
• 国内部分运营商、校园网、企业办公网会默认封禁27017端口，这种情况可以直接切换手机热点网络重试连接，如果热点下能正常连通，即可确认是原有网络的端口访问限制。M0免费层集群不支持自定义连接端口，只能使用连通性正常的网络访问。

排查方向2：修正连接字符串配置错误 #

你当前使用的连接代码存在两个显性问题：

• 连接参数分隔符是HTML转义后的&，直接复制网页代码到本地运行时，转义字符会导致URL参数解析失败，需要全部替换为&
• useNewUrlParser、useUnifiedTopology是MongoClient构造函数的独立配置项，不属于URL连接参数，放在URL中不会生效，部分驱动版本下会触发拓扑选择异常

修正后的参考代码如下：

const { MongoClient } = require('mongodb')
const url = 'mongodb+srv://user:pass@mmmcluster.axapu.mongodb.net/appname?retryWrites=true&w=majority'
const client = new MongoClient(url, {
  useNewUrlParser: true,
  useUnifiedTopology: true,
  serverSelectionTimeoutMS: 30000 // 延长拓扑选择超时时间，规避网络波动导致的误判
})

async function run() {
  try {
    await client.connect()
    console.log('Connected correctly to server')
  } catch (err) {
    console.log(err.stack)
  } finally {
    await client.close()
  }
}

run().catch(console.dir)

排查方向3：核对Atlas集群侧配置 #

• 检查集群网络设置：如果开启了「仅专用端点访问」模式，公网发起的连接会被直接丢弃，需要在控制台网络配置页开启公网访问权限
• 确认集群运行状态：M0免费层集群长时间无连接会自动进入休眠状态，首次唤醒连接需要1-2分钟，超时可以多重试2-3次；如果集群处于维护、升级状态，等待状态恢复为Running后再连接即可
• 集群区域连通性校验：部分海外区域的Atlas节点国内访问存在路由丢包问题，可以在控制台将集群迁移到新加坡、东京等邻近可用区，提升连通率

排查方向4：排查本地环境路由冲突 #

• 完全退出本地运行的所有代理、VPN类工具后重试：Node.js默认不会读取系统代理规则，代理工具的网络驱动可能篡改路由表，导致到Atlas节点的连接被路由到无效地址
• 刷新本地DNS缓存：在命令提示符执行ipconfig /flushdns清空本地DNS缓存，避免错误域名映射导致的连接失败
• 检查本地hosts文件：删除所有和mongodb.net域名相关的手动映射规则，避免错误IP指向导致的超时

以上所有排查步骤均不需要安装Compass，全部基于官方原生驱动和系统自带工具完成，符合官方原生连接的使用要求。

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