Node.js Express自定义process.env变量无法跨文件访问的求助

问题场景 #

• 基于Node.js和Express开发应用，使用dotenv从.env文件加载配置变量
• 仅主文件index.js能正常访问process.env变量，其他项目文件中访问（如process.env.DB_SERVER）返回undefined
• .env示例内容：

database=application

• index.js现有代码：

const dotenv = require('dotenv');
dotenv.config({ path: './config/config.env' })
const HOSTNAME = process.env.HOST || 'localhost';
const PORT = process.env.PORT || 3000;

解决方案 #

方法1：优先初始化dotenv（最简便） #

Node.js模块加载是同步执行的，只需确保dotenv.config()在所有其他模块require之前执行即可。调整index.js的代码顺序：

// 放在代码最开头，先加载环境变量
const dotenv = require('dotenv');
dotenv.config({ path: './config/config.env' });

// 之后再加载其他依赖或自定义模块
const express = require('express');
const app = express();
const dbConnector = require('./utils/db-connector'); // 该文件可正常访问process.env

const HOSTNAME = process.env.HOST || 'localhost';
const PORT = process.env.PORT || 3000;

方法2：创建统一配置模块（推荐） #

专门封装一个配置模块，集中加载并导出环境变量，其他文件直接引用该模块，避免重复配置：

1. 创建config/index.js文件：

const dotenv = require('dotenv');
const path = require('path');

// 使用绝对路径确保文件位置正确
dotenv.config({ path: path.resolve(__dirname, './config.env') });

// 导出需要的配置变量
module.exports = {
  database: process.env.database,
  DB_SERVER: process.env.DB_SERVER,
  host: process.env.HOST || 'localhost',
  port: process.env.PORT || 3000
};

2. 在index.js中引用：

const config = require('./config');
const HOSTNAME = config.host;
const PORT = config.port;

3. 在其他文件（如数据库配置文件）中引用：

const config = require('../config');
console.log(config.database); // 正常获取.env中的值

方法3：全局挂载（不推荐） #

临时应急可将配置挂载到全局对象，但会污染全局环境，不适合大型项目：
在index.js加载dotenv后添加：

global.appConfig = {
  database: process.env.database,
  DB_SERVER: process.env.DB_SERVER
};

其他文件中直接使用：

console.log(global.appConfig.database);

注意事项 #

• 确保.env文件路径正确：若使用相对路径，需以Node.js启动目录为基准；推荐用path.resolve()生成绝对路径避免路径问题
• 务必将.env文件加入.gitignore，防止敏感配置泄露到版本库

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