Express服务器调用Cloudinary上传图片返回空对象且上传失败求助

问题排查与解决步骤 #

• 修正.env配置文件语法
  你给出的示例.env中CLOUD_NAME用了冒号:赋值，正确的env文件键值对必须用等号=：

CLOUD_API_KEY=你的真实API_KEY
CLOUD_NAME=你的真实CLOUD_NAME
CLOUD_API_SECRET=你的真实API_SECRET

确认项目入口文件（一般是app.js/server.js）有引入dotenv并执行配置，且加载位置在cloudinary配置之前：

require('dotenv').config()
// 后面再写cloudinary配置、路由加载等逻辑

• 补全缺失的fs模块引入
  你当前代码中removeTmp函数调用了fs.unlink，但文件顶部没有引入fs模块，在文件顶部添加：

const fs = require('fs')

• 确认express-fileupload中间件配置正确
  你用到了req.files获取上传文件，必须确保入口文件中配置了express-fileupload，且开启了临时文件存储，否则file.tempFilePath不存在：

const fileUpload = require('express-fileupload')
app.use(fileUpload({
  useTempFiles: true,
  tempFileDir: '/tmp/'
}))

• 修正异步错误捕获逻辑
  你当前cloudinary上传用的是回调写法，回调内部抛出的错误无法被外层的try/catch捕获，会导致无响应返回。可以改成async/await写法避免回调嵌套问题：
  把上传部分的代码替换为：

// 路由回调改成async
router.post('/upload',auth , authAdmin, async (req, res) =>{
  try {
    // 原有文件校验逻辑保留
    if(!req.files || Object.keys(req.files).length === 0)
      return res.status(400).json({msg: 'No files were uploaded.'});
    
    const file = req.files.file;
    if(file.size > 1024*1024) {
      removeTmp(file.tempFilePath);
      return res.status(400).json({msg: "Size too large"});
    }

    if(file.mimetype !== 'image/jpeg' && file.mimetype !== 'image/png'){
      removeTmp(file.tempFilePath);
      return res.status(400).json({msg: "File format is incorrect."});
    }

    console.log(req.files) ;
    // 改为await调用上传接口
    const result = await cloudinary.v2.uploader.upload(file.tempFilePath, {folder: "test"})
    removeTmp(file.tempFilePath)
    res.json({public_id: result.public_id, url: result.secure_url})
  } catch (err) {
    // 所有错误都会被这里捕获返回
    if(req.files?.file?.tempFilePath) removeTmp(req.files.file.tempFilePath)
    return res.status(500).json({msg: err.message});
  }
});

• 验证cloudinary配置加载有效性
  可以在cloudinary.config代码之后加一行日志，确认配置是否正确读取：

console.log(cloudinary.config())
// 检查控制台输出的cloud_name、api_key、api_secret是否和你填写的一致

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