部署API后MongoDB连接报错：连接字符串格式不符合要求

可能的原因及解决方案 #

1. .env文件未正确加载 #

• 问题核心：process.env.MONGODB_URI可能为undefined或空值，导致mongoose使用无效的连接字符串触发报错
• 解决步骤：
  • 安装依赖：执行 npm install dotenv 确保dotenv已安装
  • 在db.js顶部添加.env加载逻辑：

    import dotenv from 'dotenv';
    dotenv.config();
    

  • 添加日志验证：在连接代码前插入日志，确认环境变量是否正确读取

    console.log("当前MONGODB_URI:", process.env.MONGODB_URI);
    

2. 连接字符串不完整或格式错误 #

• 问题核心：你提供的.env中连接字符串末尾为...，大概率未复制完整的MongoDB官方连接字符串
• 解决步骤：
  • 从MongoDB控制台复制完整连接字符串，标准格式应为：

    MONGODB_URI=mongodb+srv://<用户名>:<密码>@集群地址.mongodb.net/<数据库名>?retryWrites=true&w=majority
    

  • 若密码包含@、$、&等特殊字符，需进行URL编码：
    • @ → %40
    • $ → %24
    • & → %26

3. 连接代码逻辑缺陷 #

• 问题核心：原代码中缓存的cachedMongoConn是mongoose.connect()返回的Promise对象，而非实际连接实例，可能导致连接状态异常
• 优化后的连接代码：

  import mongoose from "mongoose";
  import dotenv from 'dotenv';
  
  dotenv.config();
  mongoose.set("strictQuery", false);
  
  let cachedConn = null;
  
  export const connectToDatabase = async () => {
    if (cachedConn) {
      console.log("MongoDB: 使用缓存连接");
      return cachedConn;
    }
  
    try {
      const conn = await mongoose.connect(process.env.MONGODB_URI, {
        connectTimeoutMS: 60000,
        bufferCommands: false
      });
      cachedConn = conn;
      console.log(`连接成功: ${conn.connection.host}:${conn.connection.port}/${conn.connection.name}`);
      return conn;
    } catch (error) {
      console.error("连接失败:", error);
      throw error;
    }
  };
  

  • 注意：新版本mongoose已默认启用useNewUrlParser和useUnifiedTopology，无需手动配置

4. 环境变量拼写错误 #

• 检查.env中变量名是否严格为MONGODB_URI，确保和代码中调用的变量名完全一致（环境变量名大小写敏感）

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