嵌套Node模块无法访问dotenv环境变量，求排查解决

问题本质 #

你碰到的问题核心是ES模块的导入提升机制：所有import语句会被优先提升到模块执行前处理。哪怕你把dotenv.config()写在import代码的前面，实际执行顺序也是先加载所有导入的模块（包括db.js），再运行dotenv.config()加载环境变量。所以db.js执行时，环境变量还没被注入，自然返回undefined。

具体解决方法 #

方法1：启动时预加载dotenv

直接通过Node.js的-r参数，让程序在加载任何业务模块前先加载dotenv，这样所有模块都能直接访问环境变量：

# 在root目录下执行
node -r dotenv/config server/server.js

如果启动时需要指定.env路径（比如你的执行目录不是root），可以追加参数：

node -r dotenv/config server/server.js dotenv_config_path=./.env

方法2：将dotenv封装为前置加载模块

在server目录下新建config.js：

// server/config.js
import dotenv from 'dotenv';
dotenv.config({ path: '../.env' });

然后在server.js的最开头优先导入这个配置模块：

// server/server.js
import './config.js'; // 必须放在所有import最前面
import express from 'express';
import cors from 'cors';
import sequelize from './database/db.js';
import { User } from './database/models.js';

// 后续业务代码保持不变

方法3：用动态导入延迟加载数据库模块

把db.js和models.js的导入改成动态导入，确保在dotenv加载完成后再加载这些模块：

// server/server.js
import dotenv from 'dotenv';
dotenv.config({ path: '../.env' });

import express from 'express';
import cors from 'cors';

// 动态导入数据库相关模块
const { default: sequelize } = await import('./database/db.js');
const { User } = await import('./database/models.js');

const app = express();
const PORT = process.env.SERVER_PORT || 5000;

// 后续业务代码保持不变

注意：这种方法需要将server.js的顶层代码改为异步，或者把业务逻辑包裹在异步函数中执行。

为什么之前的调整没用？ #

你之前修改.env路径或调整dotenv.config的位置无效，是因为ES模块的import提升特性——不管import语句写在代码的哪个位置，Node.js都会先处理所有导入操作，再执行模块内的其他代码。所以db.js的执行时机永远早于dotenv.config()的执行，自然拿不到环境变量。

内容的提问来源于stack exchange，提问作者Jiří Honzák