如何实现ES6同步导入？模块导入顺序问题致Mongo连接失败求解决

问题核心 #

ES6的静态import语句会被JavaScript引擎优先解析执行，无论它在代码中的位置如何。这就导致你在index.js中加载dotenv的代码还没执行完，mongoose.service.js就已经被加载并执行，此时process.env还未被注入环境变量，最终引发MongoDB连接失败。

解决方案1：使用动态导入替代静态导入 #

将静态的import './services/mongoose.service.js'替换为异步的动态导入，确保环境变量加载完成后再加载并执行mongoose模块：

修改index.js的代码，将顶层逻辑包裹在异步自执行函数中：

import joi from 'joi';
import dotenv from 'dotenv';

(async function() {
    const config = dotenv.config();
    if (config.error) {
        console.error(config.error);
        process.exit(1);
    }
    const configError = joi.object({
        HTTP_URL_FRONT: joi.string().uri().required(),
        JWT_SECRET: joi.string().required(),
        DIR_DATA: joi.string().required(),
        DIR_TMP: joi.string().required(),
        MONGODB_URI: joi.string().required()
    }).required().validate(config.parsed).error;
    if (configError) {
        console.error(".env invalide", configError);
        process.exit(1);
    }

    console.log("1", process.env.HTTP_URL_FRONT)
    // 用动态导入替代静态导入，等待环境变量加载完成
    await import('./services/mongoose.service.js');
    console.log("3", process.env.HTTP_URL_FRONT)
})().catch(err => {
    console.error(err);
    process.exit(1);
});

动态导入是异步操作，会等待环境变量加载完成后才执行mongoose.service.js的代码，确保process.env.MONGODB_URI有值。

解决方案2：将环境变量加载抽为前置依赖模块 #

创建单独的config.js模块专门负责加载和验证环境变量：

import dotenv from 'dotenv';
import joi from 'joi';

const config = dotenv.config();
if (config.error) {
    console.error(config.error);
    process.exit(1);
}
const configError = joi.object({
    HTTP_URL_FRONT: joi.string().uri().required(),
    JWT_SECRET: joi.string().required(),
    DIR_DATA: joi.string().required(),
    DIR_TMP: joi.string().required(),
    MONGODB_URI: joi.string().required()
}).required().validate(config.parsed).error;
if (configError) {
    console.error(".env invalide", configError);
    process.exit(1);
}

export default config.parsed;

然后在所有依赖环境变量的模块中先导入这个config.js：
修改mongoose.service.js：

import '../config.js'; // 确保环境变量先加载完成
console.log("2", process.env.HTTP_URL_FRONT);
import mongoose from 'mongoose';

(async function () {
    await mongoose.connect(process.env.MONGODB_URI);
})().catch(e => {
    console.error(e);
    process.exit(1);
});

export default mongoose;

修改index.js：

import './config.js'; // 前置加载配置
import joi from 'joi';

console.log("1", process.env.HTTP_URL_FRONT)
import './services/mongoose.service.js';
console.log("3", process.env.HTTP_URL_FRONT)

ES6模块的依赖解析机制会保证config.js的代码在所有依赖它的模块之前执行，从而提前完成环境变量的注入。

解决方案3：启动时预先加载环境变量 #

在启动Node.js应用时，使用--require（简称-r）参数预先加载dotenv，让环境变量在所有模块执行前就被注入：

node -r dotenv/config index.js

也可以在package.json的scripts中配置启动命令：

{
  "scripts": {
    "start": "node -r dotenv/config index.js"
  }
}

这种方式无需修改代码结构，直接通过启动参数确保环境变量提前就绪。

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