使用Mongoose连接MongoDB Atlas时触发MongoParseError：URI格式错误

可能的原因及修复方案 #

1. 检查原始DB模板URI的完整性 #

确认process.env.DB的原始值是MongoDB Atlas提供的完整标准URI，格式应为：

mongodb+srv://<username>:<password>@cluster0.mongodb.net/<dbname>?retryWrites=true&w=majority

• 确保没有遗漏<username>、<dbname>等占位符，也没有多余的空格或符号
• 不要省略URI中的+srv标识，这是Atlas集群连接的必要组成部分

2. 验证密码替换逻辑 #

即使密码无特殊字符，也需确认：

• process.env.DB_PASSWORD是否正确加载，有没有出现空值或额外空格。可以临时添加代码打印替换后的URI：

  console.log('生成的DB地址:', DB);
  

  直接检查输出内容，确认<password>被完全替换，没有残留占位符（比如环境变量名拼写错误导致process.env.DB_PASSWORD为undefined）

3. 移除过时的Mongoose连接选项 #

Mongoose 6.x及以上版本已移除useNewUrlParser、useCreateIndex、useFindAndModify这些旧选项，保留它们可能干扰连接逻辑。简化后的连接代码如下：

const mongoose = require('mongoose');
const DB = process.env.DB.replace('<password>', process.env.DB_PASSWORD);
mongoose
  .connect(DB)
  .then((con) => {
    console.log('DB连接成功!');
  })
  .catch(err => console.error('连接错误:', err));

添加.catch()能更精准捕获并展示连接过程中的错误细节

4. 确认环境变量加载正常 #

如果使用dotenv管理环境变量，确保在代码开头添加了加载逻辑：

require('dotenv').config();

未正确加载环境变量会导致process.env.DB和process.env.DB_PASSWORD为undefined，生成完全无效的URI

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