cloudinary.config()中无法访问环境变量的问题排查

两个核心问题导致环境变量读取失败：

1. 代码执行顺序错误：ES模块的import语句会被静态提升，优先于文件内其他同步代码执行。你的dotenv.config()写在业务模块导入语句之后，storage.tsx在被导入时就会同步执行cloudinary.config()读取环境变量，此时dotenv还未完成.env文件的加载注入，读到的process.env.CLOUDINARY_*值均为undefined，自然会抛出鉴权/配置错误。其他位置环境变量能正常生效，是因为对应代码运行时机在dotenv初始化完成之后。
2. .env文件写法不规范：变量赋值的等号两侧加了多余空格，部分低版本dotenv解析时会将空格计入key名或变量值，导致变量名匹配失败，读不到正确值。

• 调整dotenv初始化位置：将dotenv.config()调用放到所有业务模块导入语句之前，保证所有业务代码加载时环境变量已经完成注入。更稳妥的方式是把dotenv初始化逻辑放到项目启动入口文件（如server.ts/index.ts）的最顶部，避免模块加载顺序带来的问题。
  修正后的app.tsx开头代码如下：

  import dotenv from "dotenv";
  // 最先执行环境变量加载
  dotenv.config({ path: __dirname + "/.env" });
  
  // dotenv初始化完成后再导入所有业务模块
  import express from "express";
  import cookieParser from "cookie-parser";
  import helmet from "helmet";
  import connectDB from "./config/db";
  import errorMiddleware from "./middlewares/errorMiddleware";
  import generalRouter from "./routes/generalRoute";
  import authRouter from "./routes/authRoute";
  import cors from "cors";
  
  connectDB();
  const app = express();
  app.use(
    helmet({
      crossOriginResourcePolicy: false,
    })
  );
  app.use(cookieParser());
  app.use(express.json());
  app.use(express.urlencoded({ extended: false }));
  
  //Routes
  app.use("/api/", generalRouter);
  app.use("/api/auth", authRouter);
  app.use(errorMiddleware);
  
  export default app;
  

• 修正.env文件格式，去掉等号两侧的空格，填入你自己的Cloudinary真实凭证：

  NODE_ENV=development
  PORT=5000
  CLOUDINARY_NAME=替换为你的Cloudinary云名称
  CLOUDINARY_KEY=替换为你的Cloudinary API Key
  CLOUDINARY_SECRET=替换为你的Cloudinary API Secret
  

• 可选调试校验：修改完成后可以在storage.tsx的配置逻辑前加临时日志，确认变量读取正常。注意：调试时不要打印完整的CLOUDINARY_SECRET值，避免敏感信息泄露：

  import { v2 as cloudinary } from "cloudinary";
  import { CloudinaryStorage } from "multer-storage-cloudinary";
  
  // 临时调试逻辑，验证通过后可删除
  console.log("Cloudinary配置校验：", {
    cloud_name: process.env.CLOUDINARY_NAME,
    api_key: process.env.CLOUDINARY_KEY,
    secret_loaded: !!process.env.CLOUDINARY_SECRET
  })
  
  cloudinary.config({
    cloud_name: process.env.CLOUDINARY_NAME,
    api_key: process.env.CLOUDINARY_KEY,
    api_secret: process.env.CLOUDINARY_SECRET,
    secure: process.env.NODE_ENV === "production",
  });
  
  const storage = new CloudinaryStorage({
    cloudinary,
    params: <any>{
      folder: "ProfilePictures",
      allowedFormats: ["jpeg", "png", "jpg"],
    },
  });
  
  export default storage;
  

  如果日志输出的三个校验值都符合预期，重启服务后Cloudinary功能即可正常通过环境变量加载配置。

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