Node.js使用aws3、multerS3时如何解决bucket is required报错

• 核心原因：你代码里传入的process.env.AWS_BUCKET_NAME实际运行时值为undefined，和你有没有在config.env里写变量没有直接关系，90%以上是环境变量加载逻辑出了问题，按以下步骤排查修复即可：

1. 优先确认dotenv加载逻辑是否正确 #

你必须在所有业务代码执行前加载config.env文件，否则运行时读不到配置的环境变量：

• 若未安装dotenv依赖，先执行安装命令：

npm install dotenv

• 在项目入口文件（通常是server.js/app.js）的最顶部，也就是所有require/import业务代码、multer配置代码之前，添加环境变量加载代码：

// 这行必须放在文件最开头
require('dotenv').config({ path: './config.env' });

注意：如果你的config.env文件不在项目根目录，需要把path参数改成config.env的实际相对路径，路径错误会导致dotenv静默加载失败，不会抛错但也读不到变量。

2. 校验环境变量实际值，排除配置拼写错误 #

在multer配置代码前加一行调试日志，确认变量是否成功读取：

console.log('S3桶名读取结果：', process.env.AWS_BUCKET_NAME);

如果打印结果为undefined，逐一排查以下问题：

• config.env内的变量名是否和代码里完全一致，有没有拼写错误、变量名前后多空格
• config.env内的配置格式是否正确，不要给变量值加多余的引号、前后不要留空格，正确写法示例：AWS_BUCKET_NAME=my-project-upload-bucket
• 检查是否在系统环境变量、项目启动脚本中覆盖了同名变量

3. 检查multer初始化时机 #

不要在dotenv加载完成前初始化multer配置，否则初始化时环境变量还未注入到process.env中，拿到的还是undefined：

// ❌ 错误写法：dotenv加载在multer初始化之后
const upload = multer({
  storage: multerS3({
    s3,
    bucket: process.env.AWS_BUCKET_NAME, // 此时值为undefined
    key: function (req, file, cb) {
      cb(null, `user-${req.user.id}-${Date.now()}.jpeg`);
    },
  }),
});
require('dotenv').config({ path: './config.env' });

调整代码顺序，把dotenv加载逻辑移到文件最顶部即可。

额外提示：你贴的代码里key回调的第二个参数写的是res，实际multerS3的key回调第二个参数是上传的文件对象file，虽然不是触发本次bucket报错的原因，但后续处理文件时会出现异常，建议同步修正。

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