MongoDB Atlas与Mongoose连接失败：mongosh/Compass可正常连接

问题概述 #

使用Node.js + Mongoose连接MongoDB Atlas集群时出现MongooseServerSelectionError，提示无法连接集群，但通过mongosh和MongoDB Compass可正常连接，已配置IP白名单（包括允许所有IP 0.0.0.0/0）、验证凭证正确性并重启服务器。

可能的解决方案 #

1. 升级或验证Mongoose版本兼容性 #

部分旧版本Mongoose与MongoDB Atlas的高版本集群（如MongoDB 6.0+）存在兼容性问题，导致连接失败。

• 执行命令升级到最新稳定版：

  npm install mongoose@latest
  

• 若暂时不想升级，可在连接时显式添加兼容选项（适配旧版本Mongoose）：

  mongoose.connect(uri, {
    useNewUrlParser: true,
    useUnifiedTopology: true
  })
  

2. 转义连接URI中的特殊字符 #

如果数据库密码包含@、$、!等特殊字符，直接写入URI会导致解析错误（mongosh/Compass会自动处理转义，但Node.js不会）。需手动对密码进行URL编码：

const mongoose = require("mongoose");
const username = "<username>";
const password = encodeURIComponent("<password>"); // 转义特殊字符
const uri = `mongodb+srv://${username}:${password}@cluster0.0sgfn.mongodb.net/eateasy?retryWrites=true&w=majority&appName=Cluster0`;

mongoose.connect(uri)
  .then(() => console.log("MongoDB connected..."))
  .catch(err => console.log("MongoDB connection error:", err));

3. 添加显式连接选项 #

显式指定连接参数可解决部分网络解析或超时问题，尤其是以下选项：

mongoose.connect(uri, {
  serverSelectionTimeoutMS: 5000, // 缩短超时时间，快速反馈连接状态
  family: 4, // 强制使用IPv4，避免IPv6解析失败
  socketTimeoutMS: 45000,
  maxPoolSize: 10
})

其中family:4是常见排查点——部分环境下IPv6配置异常，导致Node.js无法解析集群地址，但mongosh/Compass默认使用IPv4。

4. 排查Node.js进程的网络限制 #

即使系统层面网络正常，Node.js进程可能受代理、防火墙或IDE配置限制：

• 尝试直接在终端运行Node.js脚本，而非通过IDE启动，排除IDE代理影响；
• 检查系统环境变量中的HTTP_PROXY/HTTPS_PROXY，若存在代理，需在Mongoose连接中配置代理，或临时取消代理；
• 临时关闭本地防火墙，验证是否是防火墙阻止了Node.js的出站连接。

5. 移除连接字符串中的appName参数 #

部分场景下，&appName=Cluster0参数可能导致连接异常，尝试移除该参数后重新连接。

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