Node.js + dotenv特定文件无法访问环境变量问题求助

问题原因 #

ES模块采用静态导入机制，所有import语句会在模块执行代码前优先解析加载。你的项目中，cloudinary.config.js、imageUploader.js这些文件的导入链（server.js → authController.js → imageUploader.js → cloudinary.config.js）会在server.js里的dotenv.config()执行前就完成加载，导致这些文件执行时process.env还未被注入环境变量。

解决方案 #

方案1：启动时预先加载dotenv（推荐）

修改package.json的启动脚本，使用Node.js的-r参数在启动时预先加载dotenv，确保所有模块加载前环境变量已就绪：

{
  "scripts": {
    "start": "node -r dotenv/config server.js"
  }
}

这种方式无需修改任何模块代码，一劳永逸解决所有模块的环境变量访问问题。

方案2：在需要环境变量的文件中手动加载dotenv

如果不想修改启动脚本，可以在直接使用环境变量的文件（比如cloudinary.config.js）顶部手动加载dotenv：

import dotenv from 'dotenv';
// 若.env不在当前文件同级目录，需指定路径，比如当前在config/下，路径为../.env
dotenv.config({ path: '../.env' });

import { v2 as cloudinary } from 'cloudinary';

cloudinary.config({
    cloud_name: process.env.cloudinary_cloud_name,
    api_key: process.env.cloudinary_api_key,
    api_secret: process.env.cloudinary_api_secret
});

export default cloudinary;

注意：这种方式需要在每个依赖环境变量的文件中重复添加，维护成本较高。

方案3：避免静态导入（不推荐）

如果允许使用动态导入，可以将imageUploader.js的导入改为动态导入，确保在dotenv.config()执行后再加载：
在authController.js中：

// 替换静态import为动态import
const uploadImage = await import('../helpers/imageUploader.js').then(module => module.default);

但这种方式会改变代码结构，且可能影响性能，不推荐在生产环境使用。

补充说明 #

你的multer.config.js当前代码未使用环境变量，若后续需要添加依赖环境变量的配置，同样适用上述方案。

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