mongoose.connect()报URI未定义错误，跨文件调用连接函数失败

问题场景 #

运行database/db.js时能正常连接MongoDB，但通过server/server.js引用并调用其中的连接函数时，触发以下错误：

MongooseError: The uri parameter to openUri() must be a string, got "undefined". Make sure the first parameter to mongoose.connect() or mongoose.createConnection() is a string.

项目结构：

ROOT
|_ node_modules/
|_ package.json
|_ yarn.lock
|_ client/
|_ database/
|   |_ node_modules/
|   |_ db.js
|   |_ package.js
|   |_ .env
|   |_ yarn.lock
|_ server
    |_ controllers/
    |_ middleware/
    |_ routes/
    |_ server.js
    |_ package.json
    |_ yarn.lock 

问题原因 #

dotenv.config()默认从当前Node.js进程的工作目录加载.env文件：

• 直接运行db.js时，进程工作目录是database/，能正确读取该目录下的.env；
• 从server.js引用db.js时，进程工作目录是项目根目录（或启动server.js时的目录），此时dotenv无法找到database/下的.env，导致process.env.ATLAS_URI为undefined。

解决方案 #

方法1：指定.env文件的绝对路径（推荐） #

修改db.js中的dotenv加载逻辑，使用path模块指定.env的绝对路径，确保无论从哪里引用都能加载到正确的文件：

const path = require('path');
// 明确指定当前模块目录下的.env文件
require('dotenv').config({ path: path.resolve(__dirname, '.env') });
const mongoose = require('mongoose');

const URI = process.env.ATLAS_URI;
console.log(URI);

const mongoDB = async () => {
    try {
        const connectionParams = {
            useNewUrlParser: true,
            useUnifiedTopology: true
        };
        await mongoose.connect(URI, connectionParams);
        console.log('Connected to database ✅');
    } catch (error) {
        console.error('Error connecting to Database ❎\n', error);
    }
};

module.exports = mongoDB;

__dirname代表当前模块（db.js）所在的目录，path.resolve(__dirname, '.env')会生成database/.env的绝对路径，彻底解决路径问题。

方法2：将.env移到项目根目录 #

把database/.env移动到项目ROOT目录下，此时dotenv.config()默认会加载根目录的.env，无需修改db.js中的加载代码。这种方法适合希望统一管理环境变量的场景。

验证修改 #

修改完成后，运行server/server.js，查看控制台输出的URI是否为正确的MongoDB连接字符串，确认数据库连接正常。

内容的提问来源于stack exchange，提问作者Mr.Unforgettable