NodeJS连接MongoDB Atlas集群失败问题排查求助

我正在开发ExpressJS Web服务项目，使用MongoDB Atlas免费集群，采用官方提供的连接字符串尝试连接数据库。已将自身IP加入白名单，甚至设置为允许所有IP访问，但仍连接失败。本地MongoDB可正常连接，个人认为代码无问题，但仍提供代码供排查。已尝试SRV与非SRV格式的连接地址，且MongoDB Compass、Mongosh及VS Code MongoDB扩展均可正常连接该集群，却在NodeJS中收到IP未白名单的错误提示，现寻求代码审查及解决方案。

代码：

const express = require('express');
const bodyParser = require('body-parser')
const cors = require('cors')
const mongoose = require('mongoose');

const app = express();
const port = 8000;

// Encode username and password for mongodb as URI encoded component
const username = encodeURIComponent("<username>");
const password = encodeURIComponent("<password>")

// const mongoDbUrl = `mongodb://${username}:${password}@host:port/database`;
// const mongoDbUrl = `mongodb://${username}:${password}@diversity-of-living-clu.hqwcott.mongodb.net`;
const mongoDbUrl = "mongodb://<username>:<password>@diversity-of-living-clu.hqwcott.mongodb.net/"

// mongodb://<username>:<password>@diversity-of-living-clu.hqwcott.mongodb.net/3380DiversityOfLiving-data?retryWrites=true&w=majority&appName=diversity-of-living-cluster
// Initialising options for cors
const corsOptions = {
    origin: "*",
    credentials: true
}

app.use(bodyParser.json());
app.use(cors(corsOptions));

// Routers
const numbeoRouter = require('./DiversityOfLiving-Routers/NumbeoRouterAra65');
const userRouter = require('./DiversityOfLiving-Routers/UserRouterJpa72');
const faqRouter = require('./DiversityOfLiving-Routers/FAQRouterJpa72');
const countryCountRouter = require('./DiversityOfLiving-Routers/CountryCountRouterJpa72');
const countryDataRouter = require('./DiversityOfLiving-Routers/CountryDataRouterAra65');

// Using Routers
app.use('/numbeo', numbeoRouter);
app.use('/faq', faqRouter);
app.use('/countrycount', countryCountRouter);
app.use('/user', userRouter);
app.use('/countrydata', countryDataRouter);

app.listen(port, function () {
    console.log('Express server listening on: http://localhost:' + port);
    mongoose.connect(mongoDbUrl, { useNewUrlParser: true, useUnifiedTopology: true, connectTimeoutMS: 10000 })
    .then(() => {console.log("Connected to MongoDB");})
    .catch((err) => {console.log("Error connecting to MongoDB:", err.message, err.stack);})
});

已尝试的解决方案：

• 切换使用SRV与非SRV格式的连接地址
• 将自身IP加入白名单，并设置为允许所有IP访问

报错信息：

连接MongoDB出错：无法连接到MongoDB Atlas集群中的任何服务器。常见原因之一是你尝试从未加入白名单的IP访问数据库。请确保你的当前IP地址已在Atlas集群的IP白名单中。MongooseServerSelectionError：无法连接到MongoDB Atlas集群中的任何服务器。常见原因之一是你尝试从未加入白名单的IP访问数据库。请确保你的当前IP地址已在Atlas集群的IP白名单中。

排查与解决方案 #

1. 修复连接字符串的完整性与正确性
   你当前使用的mongoDbUrl存在两个问题：一是未使用编码后的用户名/密码，直接写了占位符<username>和<password>；二是缺少数据库名称和必要的连接参数（如retryWrites=true&w=majority）。应直接使用Atlas控制台提供的完整连接字符串，替换占位符后使用：

   const mongoDbUrl = `mongodb://${username}:${password}@diversity-of-living-clu.hqwcott.mongodb.net/3380DiversityOfLiving-data?retryWrites=true&w=majority&appName=diversity-of-living-cluster`;
   

2. 升级Mongoose版本
   旧版本Mongoose可能与Atlas的连接协议不兼容，建议升级到最新稳定版：

   npm install mongoose@latest
   

3. 验证NodeJS进程的实际出口IP
   本地工具能连接不代表NodeJS进程的出口IP一致（可能走了代理、VPN），可以添加代码打印当前出口IP，再将该IP加入白名单：

   const axios = require('axios');
   axios.get('https://api.ipify.org')
     .then(res => console.log('NodeJS出口IP:', res.data))
     .catch(err => console.log('获取IP失败:', err));
   

4. 最小化代码测试
   先排除项目中其他中间件的干扰，写一个极简的连接测试脚本：

   const mongoose = require('mongoose');
   const username = encodeURIComponent("你的真实用户名");
   const password = encodeURIComponent("你的真实密码");
   const mongoDbUrl = `mongodb://${username}:${password}@diversity-of-living-clu.hqwcott.mongodb.net/3380DiversityOfLiving-data?retryWrites=true&w=majority&appName=diversity-of-living-cluster`;
   
   mongoose.connect(mongoDbUrl, { useNewUrlParser: true, useUnifiedTopology: true })
     .then(() => console.log("连接成功"))
     .catch(err => console.log("连接失败:", err));
   

   如果这个脚本能连接，说明问题出在原项目的其他配置上；如果仍失败，重点排查网络和连接字符串。

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