.env文件中Cloudinary配置变量无法生效的问题求助

问题描述 #

基于Next.js+Express后端API的应用，将Cloudinary的cloud_name、api_key、api_secret直接写死在cloudinary.js配置中时，头像上传功能正常；但移至.env文件通过process.env调用时，出现「Must supply api_key」错误。.env文件可用（MONGO_URI能正常读取），且已在server.js中初始化dotenv。

解决方案 #

1. 确保dotenv加载顺序优先于其他模块 #

核心问题大概率是**cloudinary.js在dotenv完成配置前就被导入**，导致process.env中的Cloudinary变量尚未初始化。

修改server.js，将dotenv的配置放在所有模块导入的最顶部，确保后续模块加载时环境变量已生效：

// server.js 最顶部
import dotenv from "dotenv";
// 显式指定.env路径（可选，避免路径解析错误）
dotenv.config({ path: "./.env" });

// 再导入其他模块
import express from "express";
import cloudinary from "./path/to/cloudinary.js";
// ...其他业务模块导入

2. 核对.env变量名与代码中的拼写 #

确认.env文件中的变量名和cloudinary.js中使用的完全一致，包括大小写：

# .env 文件内容
CLOUD_NAME=你的Cloudinary云名称
CLOUD_KEY=你的Cloudinary API密钥
CLOUD_SECRET=你的Cloudinary API密钥Secret

3. 验证环境变量是否成功加载 #

在cloudinary.js中添加日志，确认变量是否被正确读取：

import { v2 as cloudinary } from "cloudinary";

// 打印变量，排查是否未加载
console.log("CLOUD_NAME:", process.env.CLOUD_NAME);
console.log("CLOUD_KEY:", process.env.CLOUD_KEY);
console.log("CLOUD_SECRET:", process.env.CLOUD_SECRET);

cloudinary.config({
  cloud_name: process.env.CLOUD_NAME,
  api_key: process.env.CLOUD_KEY,
  api_secret: process.env.CLOUD_SECRET,
});
export default cloudinary;

如果打印结果为undefined，说明变量未加载，回到步骤1检查加载顺序或.env文件路径。

4. 重启开发服务器 #

修改.env文件后，必须重启Node.js开发服务器，否则新的环境变量不会生效。

内容的提问来源于stack exchange，提问作者Stephen Scott Moore