如何解决Node.js中Mongoose连接MongoDB Atlas失败的问题？

错误信息 #

Could not connect to any servers in your MongoDB Atlas cluster. One common reason is that you're trying to access the database from an IP that isn't whitelisted. Make sure your current IP address is on your Atlas cluster's IP whitelist: https://www.mongodb.com/docs/atlas/security-whitelist/

MongoDB连接地址 #

mongodb+srv://username:password@expressmongocrud.godpihs.mongodb.net/?retryWrites=true&w=majority&appName=ExpressMongoCrud

连接代码 #

import mongoose from 'mongoose';
import config from 'config';
import log from "./logger";

async function dbConnection() {
    const dbUrl = config.get<string>("dbUrl");

    try {
        log.info("Connecting to database...");
        const connection = await mongoose.connect(dbUrl);
        log.info("Database Connected");
    } catch (e: any) {
        log.error("Database connection error");
        log.fatal(e.message);
        process.exit(1);
    }
}

export default dbConnection;

已尝试操作 #

• 使用上述连接地址通过MongoDB Compass成功连接
• 在Atlas网络访问设置中添加了当前IP地址和0.0.0.0/0，但仍出现相同错误

• 检查连接字符串的账号密码：确认username和password是Atlas数据库用户的真实凭据，若密码包含特殊字符（如@、$、&等），需进行URL编码（例如@替换为%40）。
• 升级Mongoose版本：旧版Mongoose可能对+srv格式的连接字符串支持不完善，执行npm install mongoose@latest升级到最新稳定版。
• 排查网络限制：若Node.js运行环境处于代理或防火墙后，需确保允许访问MongoDB Atlas的相关端口（27017及+srv解析出的端口），可尝试关闭代理测试。
• 验证数据库用户权限：在Atlas的「数据库访问」页面检查用户角色，确保该用户拥有目标数据库的连接及读写权限（如readWrite、dbOwner）。
• 切换为标准连接字符串：登录Atlas集群获取非+srv格式的连接字符串，替换后测试。标准格式示例：

  mongodb://username:password@expressmongocrud-shard-00-00.godpihs.mongodb.net:27017,expressmongocrud-shard-00-01.godpihs.mongodb.net:27017,expressmongocrud-shard-00-02.godpihs.mongodb.net:27017/?ssl=true&replicaSet=atlas-xxxxxx-shard-0&authSource=admin&retryWrites=true&w=majority
  

• 重启Node.js服务：修改配置或依赖后，重启运行代码的Node.js进程，确保配置生效。

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