MongoDB Atlas使用.env配置时报MongoServerError认证失败如何解决

核心错误原因 #

你代码中存在两处直接导致认证失败的问题：

1. mongoose连接配置项错误的把环境变量读取语句用单引号包裹，导致传入的是字符串字面量而非实际的配置值
2. 控制台输出dotenv.parsed为undefined，说明.env文件没有被正确加载

具体修复步骤 #

第一步：修复mongoose连接配置 #

将app.js中mongoose连接部分的配置项去掉单引号，修改为以下代码：

mongoose
.connect(process.env.DB_URI,{
  dbName: process.env.DB_NAME,
  user: process.env.DB_USER,
  pass: process.env.DB_PASS,
})

第二步：修复dotenv加载异常问题 #

首先确认：

• .env文件存放在项目根目录，和app.js同层级
• 文件名就是.env，没有多余的后缀（比如.env.txt是无效的）
• .env文件中每行配置的=前后不要加多余空格，值的前后也不要加引号（除非你本身的密码就带引号）

如果还是加载不到环境变量，可以给dotenv指定绝对路径加载，修改dotenv初始化代码为：

import dotenv from "dotenv";
import path from 'path'
import { fileURLToPath } from 'url'
const __filename = fileURLToPath(import.meta.url)
const __dirname = path.dirname(__filename)
dotenv.config({ path: path.join(__dirname, '.env') })
// 打印确认环境变量加载正确
console.log('数据库用户名：', process.env.DB_USER)

第三步：额外排查项 #

如果修改完还是报错，确认以下内容：

• MongoDB Atlas后台已经将你当前设备的IP加入IP白名单，测试阶段可以临时设置为允许所有IP访问（0.0.0.0/0）
• 你配置的数据库用户名密码正确，用户有对应数据库的操作权限
• DB_URI的格式正确，没有拼写错误

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