NodeJS中Config无法加载自定义环境变量及配置覆盖问题求助

问题梳理 #

当前遇到两个核心问题：

• default.ts无法从custom-environment-variables.ts加载变量
• custom-environment-variables.ts无法读取.env文件的值
  需要实现custom-environment-variables.ts的配置覆盖default.ts，已尝试重启控制台、测试环境运行Node，均无效。

相关代码：

// default.ts
export default {
    accessTokenPrivateKey: "",
    refreshTokenPrivateKey: "",
};

// custom-environment-variables.ts
export default {
    accessTokenPrivateKey: "ACCESS_TOKEN_PRIVATE_KEY",
    accessTokenPublicKey: "ACCESS_TOKEN_PUBLIC_KEY",
    refreshTokenPrivateKey: "REFRESH_PRIVATE_KEY",
    refreshTokenPublicKey: "REFRESH_PUBLIC_KEY"
};

解决方案 #

1. 确保.env文件正确配置 #

• 在项目根目录创建.env文件，内容格式如下（变量名与custom-environment-variables.ts中的映射名完全一致，大小写敏感）：

  ACCESS_TOKEN_PRIVATE_KEY=你的私钥内容
  ACCESS_TOKEN_PUBLIC_KEY=你的公钥内容
  REFRESH_PRIVATE_KEY=你的刷新令牌私钥内容
  REFRESH_PUBLIC_KEY=你的刷新令牌公钥内容
  

  注意：不要给变量值加引号，不要在=前后加空格。

2. 正确引入dotenv加载环境变量 #

如果使用node-config包，部分版本需要手动引入dotenv来读取.env文件：

• 安装依赖：

  npm install dotenv --save
  

• 在项目入口文件（如server.ts/index.ts）的最顶部添加：

  import dotenv from 'dotenv';
  dotenv.config();
  

  确保这部分代码在引入config之前执行。

3. 确认node-config的加载逻辑 #

node-config的加载优先级为：default.ts < custom-environment-variables.ts，后者会自动覆盖前者的同名配置项。需要确保：

• 配置文件放在项目根目录的config文件夹下，目录结构正确：

  项目根目录/
  ├── config/
  │   ├── default.ts
  │   └── custom-environment-variables.ts
  ├── .env
  └── 入口文件.ts
  

• TS项目需确保tsconfig.json中包含对config目录的编译配置，比如：

  {
    "compilerOptions": {
      "rootDir": "./src",
      "outDir": "./dist",
      "resolveJsonModule": true,
      "esModuleInterop": true
    },
    "include": ["src/**/*", "config/**/*"]
  }
  

4. 验证配置加载结果 #

在入口文件中添加验证代码，确认配置是否正确加载：

import config from 'config';

console.log('accessTokenPrivateKey:', config.get('accessTokenPrivateKey'));
console.log('refreshTokenPrivateKey:', config.get('refreshTokenPrivateKey'));

运行项目后，如果输出.env中的对应值，说明配置生效，custom-environment-variables.ts已成功覆盖default.ts。

5. 排查常见坑点 #

• 环境变量名大小写必须完全一致，比如ACCESS_TOKEN_PRIVATE_KEY不能写成access_token_private_key
• 确保.env文件在当前Node进程的工作目录下，运行项目时不要切换到子目录执行
• 如果是部署环境，不要依赖.env文件，直接在服务器/容器中设置环境变量即可
• 重启Node进程时，要确保进程完全终止后再启动，避免缓存旧配置

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