已指定区域却触发Amazon S3 PutObjectCommand的「Region is missing」错误求助

核心问题及修复步骤 #

1. S3Client配置语法错误

你的S3Client初始化代码中，region: REGION后缺少逗号，导致对象解析失败，区域参数未被正确识别：

错误代码：

const s3Client = new S3Client({
  region: REGION
  credentials: {
    accessKeyId: process.env.AWS_ACCESS_KEY_ID,
    secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,
  },
});

修复后：

const s3Client = new S3Client({
  region: REGION, // 添加缺失的逗号
  credentials: {
    accessKeyId: process.env.AWS_ACCESS_KEY_ID,
    secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,
  },
});

2. Multer文件对象处理错误

upload.fields()返回的文件是数组类型（即使maxCount设为1），直接将整个数组传给S3的Body参数会导致错误，需取数组第一个元素并使用其buffer属性：

错误代码：

const mainPhotoFile = files.mainPhoto ? files.mainPhoto : null;
// ...
const mainPhotoParams = {
  Bucket: BUCKET,
  Key: mainPhotoFile.originalname,
  Body: mainPhotoFile,
  ContentType: mainPhotoFile.mimetype,
};

修复后：

const mainPhotoFile = files.mainPhoto ? files.mainPhoto[0] : null; // 取数组第一个文件
// ...
const mainPhotoParams = {
  Bucket: BUCKET,
  Key: mainPhotoFile.originalname,
  Body: mainPhotoFile.buffer, // 使用文件的buffer作为Body
  ContentType: mainPhotoFile.mimetype,
};

额外排查建议 #

• 验证环境变量加载：在S3Client初始化前添加console.log('REGION:', REGION)，确认REGION不是undefined。
• 检查.env文件：确保AWS_REGION键名正确，值无多余空格或引号。
• 确认存储桶区域与代码指定区域完全一致（如us-west-1而非us-west-1a）。

修复后的关键代码片段 #

// 修正后的S3Client配置
const s3Client = new S3Client({
  region: REGION,
  credentials: {
    accessKeyId: process.env.AWS_ACCESS_KEY_ID,
    secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,
  },
});

// 修正后的文件上传逻辑
app.post('/upload', upload.fields([{ name: 'mainPhoto', maxCount: 1 }, { name: 'auxPhoto1', maxCount: 1 }]), async (req, res) => {
  try {
    const files = req.files;
    const mainPhotoFile = files.mainPhoto ? files.mainPhoto[0] : null;
    const auxPhotoFile = files.auxPhoto1 ? files.auxPhoto1[0] : null;

    let mainPhotoURL = null;
    let auxPhotoURL = null;

    if (mainPhotoFile) {
      const mainPhotoParams = {
        Bucket: BUCKET,
        Key: mainPhotoFile.originalname,
        Body: mainPhotoFile.buffer,
        ContentType: mainPhotoFile.mimetype,
      };
      const mainPhotoCommand = new PutObjectCommand(mainPhotoParams);
      await s3Client.send(mainPhotoCommand);
      mainPhotoURL = `https://${mainPhotoParams.Bucket}.s3.${REGION}.amazonaws.com/${mainPhotoParams.Key}`;
    }

    // 后续数据库插入逻辑保持不变
    const { clientName, clientTag1, clientTag2, clientTag3, clientDesc, clientNeeds, companySolution } = req.body;
    const query = `
      INSERT INTO portfolio (
        clientname,
        clienttag1,
        clienttag2,
        clienttag3,
        clientdesc,
        clientneeds,
        companysolution,
        mainphotourl,
        auxphoto1url
      ) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9)
    `;
    const values = [clientName, clientTag1, clientTag2, clientTag3, clientDesc, clientNeeds, companySolution, mainPhotoURL, auxPhotoURL];
    await pool.query(query, values);
    
    res.send('Data uploaded and inserted successfully.');
  } catch (err) {
    console.error(err);
    res.status(500).send('Error uploading data and files.');
  }
});

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