MongoParseError：MongoDB Atlas连接字符串协议无效，求解决方法

问题详情 #

连接MongoDB Atlas数据库时，反复遇到以下错误：

MongoParseError: Invalid scheme, expected connection string to start with "mongodb://" or "mongodb+srv://"

已尝试两种配置方式：在.env文件中硬编码用户名和密码，以及用{DBUSER}、{DBPWD}作为环境变量占位，但均未解决问题。

.env文件内容 #

ATLAS_URI = mongodb+srv://{DBUSER}:{DBPWD}@qac.mqn4ubr.mongodb.net/?retryWrites=true&w=majority

相关代码文件 #

conn.mjs

import { MongoClient } from 'mongodb'

const connectionString = process.env.ATLAS_URI || ''
console.log(connectionString)
const client = new MongoClient(connectionString)

let conn
try {
    conn = await client.connect()
} catch(err) {
    console.log(err)
}

let db = conn.db('sample_training')

export default db

loadEnvironment.mjs

import dotenv from 'dotenv'
dotenv.config()

已查阅MERN教程及社区关于该错误的解决方案，问题仍未解决，目标是让服务器正常启动运行。

解决方案 #

1. 确保环境变量优先加载 #

检查项目入口文件的导入顺序，必须先导入loadEnvironment.mjs，再导入conn.mjs。如果conn.mjs先执行，process.env.ATLAS_URI会是空字符串，直接触发错误。示例入口文件写法：

// server.mjs 或其他入口文件
import './loadEnvironment.mjs'
import db from './conn.mjs'

// 后续服务器启动逻辑

2. 修正.env文件格式 #

• 移除ATLAS_URI前后的空格，.env文件中键值对不允许有空格：

  ATLAS_URI=mongodb+srv://{DBUSER}:{DBPWD}@qac.mqn4ubr.mongodb.net/?retryWrites=true&w=majority
  

• 将{DBUSER}和{DBPWD}替换为实际的Atlas数据库用户名和密码。如果密码包含特殊字符（如@、$、/），需要进行URL编码后再填入。

3. 验证连接字符串的有效性 #

在入口文件中先打印环境变量，确认process.env.ATLAS_URI输出的是完整正确的连接字符串：

import './loadEnvironment.mjs'
console.log('加载的连接字符串：', process.env.ATLAS_URI)

如果输出为空或格式错误，说明环境变量未正确加载，需检查dotenv配置路径（可在dotenv.config()中指定路径，如dotenv.config({ path: './.env' })）。

4. 确认MongoDB驱动版本兼容性 #

mongodb+srv://格式需要驱动支持SRV记录解析，确保安装的mongodb包版本不低于3.1.0。可通过npm list mongodb查看当前版本，版本过低则执行npm install mongodb@latest更新。

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