DigitalOcean Droplet中MongoDB连接字符串格式错误求助

从错误日志和连接字符串输出可以明确两个核心问题：

1. 环境变量MONGO_PASSWORD未被正确读取，导致连接字符串出现accountUser:@这种空密码的格式
2. 空密码的URI触发了MongoParseError格式错误

一、先确认环境变量是否被后端进程正确加载 #

1. 临时打印环境变量验证
   在Mongoose连接代码前添加以下代码，直接输出环境变量值，确认是否能读取到：

// 临时调试用，测试完成后删除
console.log("MONGO_USER:", process.env.MONGO_USER);
console.log("MONGO_PASSWORD:", process.env.MONGO_PASSWORD);
console.log("MONGO_PORT:", process.env.MONGO_PORT);

如果输出中MONGO_PASSWORD为空，说明环境变量未被正确注入。

2. 针对PM2进程的环境变量配置修复
   如果用PM2管理后端进程，需确保环境变量被PM2识别：

• 创建或修改ecosystem.config.js配置文件：

module.exports = {
  apps: [{
    name: "backend",
    script: "./index.js",
    env: {
      MONGO_USER: "accountUser",
      MONGO_PASSWORD: "你的数据库密码",
      MONGO_PORT: 27017
    }
  }]
};

• 重启PM2生效：

pm2 reload ecosystem.config.js

二、修复连接字符串格式问题 #

1. 密码URL编码（关键）
   如果密码包含特殊字符（如@、:、/等），必须进行URL编码，否则会破坏URI结构：

const encodedPassword = encodeURIComponent(process.env.MONGO_PASSWORD);
const dbUri = `mongodb://${process.env.MONGO_USER}:${encodedPassword}@127.0.0.1:${process.env.MONGO_PORT}/markdatabase01?authSource=markdatabase01`;

• 注意添加authSource=markdatabase01：因为accountUser是创建在markdatabase01库下的用户，指定该参数可确保MongoDB使用正确的数据库进行认证。

2. 简化连接逻辑
   去掉嵌套的多次连接尝试，先确保单次连接逻辑正确：

const mongoose = require('mongoose');

async function connectDatabase() {
  try {
    const encodedPassword = encodeURIComponent(process.env.MONGO_PASSWORD);
    const uri = `mongodb://${process.env.MONGO_USER}:${encodedPassword}@127.0.0.1:${process.env.MONGO_PORT}/markdatabase01?authSource=markdatabase01`;
    console.log('连接URI:', uri.replace(encodedPassword, '<hidden>'));
    
    await mongoose.connect(uri);
    console.log('数据库连接成功');
  } catch (err) {
    console.error('连接失败:', err);
    process.exit(1);
  }
}

connectDatabase();

三、额外验证步骤 #

1. 检查MongoDB绑定地址
   确认MongoDB配置文件（通常为/etc/mongod.conf）中net.bindIp设置为127.0.0.1或包含该地址，确保本地进程能访问：

net:
  bindIp: 127.0.0.1

修改后重启MongoDB服务：

sudo systemctl restart mongod

2. 直接用mongosh测试连接
   在Droplet上直接用命令行测试连接，确认账号密码和URI格式是否正确：

mongosh "mongodb://accountUser:你的密码@127.0.0.1:27017/markdatabase01?authSource=markdatabase01"

如果命令行能连接成功，说明问题出在后端代码的环境变量或编码环节。

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