MERN栈学习中MongoDB连接失败：MongooseError URI未定义

问题重现 #

学习MERN栈时，连接MongoDB遇到如下报错：

Problem trying to connect to mongoDB.MongooseError: The uri parameter to openUri() must be a string, got "undefined"

已尝试重装dotenv、直接在db配置文件写入数据库URI，但问题仍未解决。相关代码如下：

主文件代码

const express = require('express');
const dotenv = require("dotenv");
dotenv.config();
const {errorHandler} = require('./middleware/errorMiddleware');
const connectDB = require('./config/db');
const port = process.env.PORT || 5000;

connectDB();

const app = express();

app.use(express.json());
app.use(express.urlencoded({extended: false}));

app.use('/api/goals', require('./routes/goalRoutes')) ;
app.use(errorHandler)

app.listen(port, () => console.log(`server started on port ${port}`));

db配置文件代码

const mongoose = require('mongoose')

const connectDB = async () => {
  try {
    const conn = await mongoose.connect(process.env.MONGO_URI)

    console.log(`MongoDB Connected: ${conn.connection.host}`)
  } catch (error) {
    console.log(error)
    process.exit(1)
  }
}

module.exports = connectDB

.env文件内容

NODE_ENV = developement
PORT = 8000
MONGO_URI = mongodb://localhost:27017/?readPreference=primary&ssl=false

排查与解决步骤 #

• 检查.env文件位置
  确保.env文件放在项目根目录（和主文件、config文件夹同级），路径不对的话，dotenv找不到文件，自然读不到变量。

• 修正.env文件格式
  变量名和值之间不能加空格，你的.env里带空格的写法会导致读取异常，改成：

  NODE_ENV=development
  PORT=8000
  MONGO_URI=mongodb://localhost:27017/?readPreference=primary&ssl=false
  

  另外注意：developement是拼写错误，正确应为development，虽然不影响连接，但建议修正。

• 显式指定dotenv路径
  如果项目结构特殊，dotenv可能找不到.env文件，在主文件里强制指定路径：

  const path = require('path');
  dotenv.config({ path: path.resolve(__dirname, '.env') });
  

• 验证环境变量读取情况
  在主文件里加一行打印，确认process.env.MONGO_URI是否有值：

  dotenv.config();
  console.log(process.env.MONGO_URI); // 查看输出是否为undefined
  connectDB();
  

  如果输出是undefined，回到前两步检查文件位置和格式；如果有值，再排查db配置文件逻辑。

• 简化MongoDB URI格式
  本地MongoDB的URI可以简化为mongodb://localhost:27017/your-db-name（建议指定具体数据库名，比如mongodb://localhost:27017/mern-app），避免复杂参数导致解析问题。

• 重启开发服务器
  修改.env文件后必须重启Node.js服务器，否则新的环境变量不会生效——很多人会忽略这一点。

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