Node.js中dotenv配置前代码已执行的问题求助

问题根源 #

ES模块的import是静态分析机制，所有导入的模块会在程序执行任何顶层代码之前就被递归加载完成。你现在的代码里，虽然import bookRoute写在了dotenv.config()之后，但实际上bookRoute依赖的book.controller.js、db.util.js早就先于dotenv.config()执行了，导致数据库模块读不到环境变量。

两种可行解决方案 #

方案1：把dotenv配置放在所有导入最前面

直接调整代码顺序，让环境变量在任何其他模块加载前就注入到process.env里：

修改后的入口文件代码：

import dotenv from 'dotenv';
// 先加载环境变量，这一步必须放在所有其他import之前
dotenv.config({ path: './config/config.env' });

// 之后再导入其他依赖
import express from 'express';
import morgan from 'morgan';

const app = express();

const PORT = process.env.PORT;
const ENV = process.env.NODE_ENV;

if (ENV === 'dev') {
  app.use(morgan('dev'));
}

const apiPrefix = '/v1';

// 现在导入路由模块时，环境变量已经就绪
import bookRoute from './routes/book.route.js';

app.use(`${apiPrefix}/book`, bookRoute);

app.listen(PORT, () => {
  console.log(`Server is running in ${ENV} mode on port ${PORT}`);
});

方案2：用动态导入延迟路由加载

如果不想调整静态导入的顺序，可以用ES模块的动态导入（import()），在dotenv配置完成后再加载路由模块：

修改入口文件的路由加载部分：

// 移除原来的静态import：import bookRoute from './routes/book.route.js';

// 改用异步方式加载路由
(async () => {
  // 等dotenv配置完成后，再动态导入路由模块
  const bookRouteModule = await import('./routes/book.route.js');
  app.use(`${apiPrefix}/book`, bookRouteModule.default);

  // 启动服务器也需要放在异步函数里，确保路由挂载完成
  app.listen(PORT, () => {
    console.log(`Server is running in ${ENV} mode on port ${PORT}`);
  });
})();

验证 #

修改完成后，控制台日志的顺序会变成dotenv在前、db.util在后，此时db.util.js里的数据库连接池就能正确读取到环境变量了。

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