Next（App Router）+Cloudinary+Mongoose图片上传报错'must supply api_key'求助

排查与解决步骤 #

1. 确认Cloudinary初始化代码是否存在且正确 #

'must supply api_key'错误90%以上是因为Cloudinary实例未完成初始化配置。你需要在调用cloudinary.uploader.upload()之前，确保已执行如下配置代码：

import 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
});

如果项目里没有这段初始化代码，或者配置参数为空，就会触发该错误。

2. 检查环境变量的配置与加载 #

• 确认项目根目录下存在.env.local文件，且文件内包含正确的Cloudinary凭证：

  CLOUDINARY_CLOUD_NAME=你的云名称
  CLOUDINARY_API_KEY=你的API密钥
  CLOUDINARY_API_SECRET=你的API密钥
  

• 检查变量名拼写是否完全正确（大小写、下划线不能错），Next.js不会自动纠正拼写错误。
• 重启Next.js开发服务器（环境变量修改后必须重启才能生效），并在初始化代码前添加日志验证：

  console.log('Cloudinary API Key:', process.env.CLOUDINARY_API_KEY);
  

  如果打印结果为undefined，说明环境变量未被正确加载，需检查.env.local文件位置、权限或变量名。

3. 验证上传代码的上下文 #

你提供的上传代码本身逻辑无问题，但要确保这段代码运行在服务器端环境（比如Route Handler、Server Component）。如果在客户端组件中直接调用Cloudinary上传，不仅会暴露API密钥，也会因为环境变量无法在客户端读取而报错。

额外提示 #

如果以上步骤都排查完毕仍有问题，可检查Cloudinary控制台的API密钥是否有效，确认没有被禁用或重置。

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