Node.js ES6环境下静态类无法读取环境变量的原因？

核心原因 #

问题出在模块加载的时机顺序：

• Node.js执行index.js时，会优先处理所有顶层import语句，也就是先加载config.js模块。
• 加载config.js时，静态属性charset会立即被赋值为当时的process.env["DATABASE_CHARSET"]——但此时你还没调用dotenv.config()加载.env.development文件，所以这个变量值是undefined。
• 后续调用dotenv.config()成功加载了环境变量，直接打印process.env["DATABASE_CHARSET"]能得到正确值，但dbConfig.charset已经在模块加载阶段被固定为undefined了。

解决方案 #

方案1：预加载指定环境变量文件（推荐）

修改package.json中的testServer脚本，通过DOTENV_CONFIG_PATH参数让dotenv/config预加载你的.env.development文件，这样模块加载前环境变量就已就绪：

"testServer":"cross-env NODE_ENV=development DOTENV_CONFIG_PATH=.env.development node -r dotenv/config ./server/index.js"

同时可以移除index.js中的dotenv.config()调用，避免重复加载。

方案2：用Getter延迟获取环境变量

修改config.js，将静态属性改为Getter方法，这样每次访问dbConfig.charset时都会实时读取process.env的值，不受模块加载顺序影响：

export class dbConfig{
    static get charset() {
        return process.env["DATABASE_CHARSET"];
    }
}

方案3：调整导入顺序（ES模块兼容写法）

由于ES模块要求import在顶层，可改用动态导入确保环境变量加载完成后再导入config.js：

import dotenv from 'dotenv';

dotenv.config({ path: '.env.' + process.env.NODE_ENV });

// 动态导入config.js
import('./config.js').then(({ dbConfig }) => {
    console.log(dbConfig);
    console.log(process.env["DATABASE_CHARSET"]);
});

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