Mongoose连接错误：openUri()的uri参数需为字符串，却获undefined

这个错误的核心原因是process.env.MONGO_URI没有读取到值，导致传入mongoose.connect()的第一个参数为undefined。按以下步骤排查修复：

• 安装并配置dotenv包
  项目需要借助dotenv加载config.env中的环境变量，先安装依赖：

  npm install dotenv
  

  在项目入口文件（如server.js、app.js）的最顶部添加代码，加载config.env文件：

  // 路径根据你的config.env实际位置调整
  require('dotenv').config({ path: './config.env' });
  
  // 之后再引入并调用数据库连接函数
  const connectDatabase = require('./path-to-your-db-connect-file');
  connectDatabase();
  

• 修正config.env文件格式
  你的config.env中变量名和值之间存在空格，会导致环境变量读取失败，改为无空格的格式：

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

  注意：将<password>替换为你MongoDB Atlas的真实密码；如果密码包含@、#、$等特殊字符，需要进行URL编码（比如@编码为%40）。

• 验证环境变量是否加载成功
  可以在数据库连接函数中先打印变量值，确认是否正常读取：

  const mongoose = require("mongoose");
  
  const connectDatabase = async () => {
    console.log(process.env.MONGO_URI); // 打印查看是否输出正确的连接字符串
    await mongoose.connect(process.env.MONGO_URI, { useNewUrlParser: true });
    console.log("MongoDB Connection Successfully");
  };
  
  module.exports = connectDatabase;
  

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