Node.js连接MongoDB出现Mongo Network Error，已加IP白名单仍未解决

算力阿峰

2026-8-18

解决Mongoose连接MongoDB Atlas时的MongoNetworkError（证书不匹配问题）

核心问题定位

从错误信息的关键提示可明确问题：

MongoNetworkError: Hostname/IP does not match certificate's altnames: Host: . is not in the cert's altnames: DNS:*.mongodb.net, DNS:mongodb.net

这说明你的MongoDB连接URL解析后得到的主机地址无效（显示为.），导致TLS证书验证失败。

解决方案

检查连接字符串正确性
确保.env文件中的MONGO_CONNECTION_URL是从MongoDB Atlas控制台完整复制的标准格式：
```
mongodb+srv://<你的用户名>:<你的密码>@<集群地址>.mongodb.net/<数据库名>?retryWrites=true&w=majority
```
重点确认：用户名、密码、集群地址、数据库名无遗漏或错误，避免空值或格式残缺。
验证环境变量加载
在connectDB函数中临时添加打印语句，确认环境变量是否正确读取：
```
require('dotenv').config();
const mongoose = require('mongoose');

function connectDB(){
    console.log('连接URL:', process.env.MONGO_CONNECTION_URL); // 临时验证用，确认后删除
    // ... 原有代码
}
```
如果打印结果为空或异常，检查：.env文件是否在项目根目录、文件名是否为.env（无后缀）、dotenv依赖是否正确安装。

简化并优化Mongoose连接代码
新版Mongoose已默认启用useNewUrlParser和useUnifiedTopology，无需手动配置，改用async/await可更直观捕获错误：

require('dotenv').config();
const mongoose = require('mongoose');

async function connectDB() {
    try {
        await mongoose.connect(process.env.MONGO_CONNECTION_URL);
        console.log('Database Connected');
    } catch (err) {
        console.error('数据库连接失败:', err);
        process.exit(1); // 连接失败时退出进程，避免无意义运行
    }
}

module.exports = connectDB;