MongoDB连接报错：uri参数未定义，是否为.env配置问题？

错误信息 #

错误：传递给openUri()的uri参数必须是字符串，得到了"undefined"。请确保mongoose.connect()的第一个参数是字符串。

这个错误基本可以确定是.env文件配置问题，导致process.env.MONGO_URL读取不到有效值，以下是具体排查和解决步骤：

排查与解决步骤 #

• 检查.env文件的位置和命名
  确保.env文件放在项目根目录，和你的入口代码文件处于同一层级，且文件名必须是.env，不能添加任何额外后缀或前缀。

• 检查.env内的变量格式
  变量名必须是MONGO_URL（注意大小写），且等号前后不能有空格，正确格式示例：

  MONGO_URL=mongodb+srv://你的用户名:你的密码@集群地址.mongodb.net/目标数据库名
  

  错误示例（带空格）：MONGO_URL = xxxxxx，这种写法会直接导致变量读取失败。

• 指定.env文件路径（如果不在根目录）
  如果你的.env文件不在入口文件同级目录，需要手动指定路径。先解开代码中注释的__dirname相关代码，再修改dotenv.config()：

  import path from "path"; // 记得引入path模块
  const __filename = fileURLToPath(import.meta.url);
  const __dirname = path.dirname(__filename);
  dotenv.config({ path: path.join(__dirname, "../.env") }); // 路径根据实际位置调整
  

• 验证环境变量是否加载成功
  在dotenv.config()之后添加一行打印代码，确认变量是否读取到：

  console.log("加载的MONGO_URL:", process.env.MONGO_URL);
  

  如果打印结果是undefined，说明上述步骤仍有问题；如果能正确输出连接字符串，再检查字符串本身是否符合MongoDB的格式要求。

补充说明 #

你代码中使用的useNewUrlParser和useUnifiedTopology参数，在Mongoose 6.x及以上版本已经是默认启用的，可以省略不写，但这不是导致当前错误的原因。

用户提供的代码 #

import cors from "cors";
import mongoose from "mongoose";
import express from "express";
import bodyParser from "body-parser";
import dotenv from "dotenv";
import morgan from "morgan";
import { fileURLToPath } from "url";


/* CONFIGURATIONS */

const __filename = fileURLToPath(import.meta.url);
// const __dirname = path.dirname(__filename);
dotenv.config();

const app = express();

app.use(express.json());
app.use(morgan("common"));
app.use(bodyParser.json({limit:"30mb", extended:true}));
app.use(bodyParser.urlencoded({limit:"30mb", extended:true}));
app.use(cors());

 /* MONGOOSE SETUP */

 const PORT = process.env.PORT;
 mongoose.connect(process.env.MONGO_URL, {
    useNewUrlParser: true,
    useUnifiedTopology: true,
 }).then(() => {
    app.listen(PORT,() => console.log(`Server Started! On Port: ${PORT}`))
 }).catch((error) => console.log(`${error} did not connect`))

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