使用presignedURL上传文件至S3时无法附加userId元数据问题

你遇到的问题核心在于S3 POST预签名表单的自定义元数据不能通过请求头传递，必须作为FormData字段提交，同时后端生成预签名时要在policy中包含该元数据的声明，否则S3会忽略未验证的元数据字段。

前端代码修改 #

把x-amz-meta-userId从请求头移到FormData中，修改uploadAPP函数：

async function uploadAPP(url_, key_, keyID_, secToken_, policy_, signature_, appFile_, userId) {
  const formdata = new FormData();
  formdata.append('key', key_);
  formdata.append('AWSAccessKeyId', keyID_);
  formdata.append('x-amz-security-token', secToken_);
  formdata.append('policy', policy_);
  formdata.append('signature', signature_);
  // 将元数据作为FormData字段添加，而非请求头
  formdata.append('x-amz-meta-userId', userId);
  formdata.append('file', appFile_, key_);

  const requestOpts = {
    method: 'POST',
    body: formdata,
    redirect: 'follow',
    // 移除手动设置的请求头，FormData会自动处理Content-Type等必要头信息
    headers: {}
  };

  // 上传文件
  const response = await fetch(url_, requestOpts);
  if (response.ok) {
    setIsLoading(false);
    setAlertOpen(true);
    fileInput.current.value = '';
  } else {
    alert(`HTTP-Error: ${response.status}`);
    setIsLoading(false);
  }
}

后端代码修改（关键步骤！） #

你的apiURL对应的后端服务，在生成预签名表单时必须将x-amz-meta-userId加入policy的验证条件中，否则S3会忽略该字段。以下是Node.js环境下的示例（基于AWS SDK v3）：

import { CreatePresignedPostCommand, S3Client } from "@aws-sdk/s3-presigned-post";

const s3Client = new S3Client({ region: "你的S3区域" });

async function generatePresignedUrl(req, res) {
  const { app: fileName } = req.body;
  // 这里假设从请求上下文获取userId，也可以直接接收前端传递的值
  const userId = req.user.id;

  const command = new CreatePresignedPostCommand({
    Bucket: "你的Bucket名称",
    Key: fileName,
    Fields: {
      // 可选：提前在字段中写入userId，也可由前端动态传递
      'x-amz-meta-userId': userId
    },
    Conditions: [
      ["content-length-range", 0, 10485760], // 限制上传文件大小（示例为10MB）
      // 允许x-amz-meta-userId字段接收任意值，若需固定值可替换为具体内容
      ["starts-with", "$x-amz-meta-userId", ""]
    ],
    Expires: 3600 // 签名有效期（1小时）
  });

  try {
    const { url, fields } = await s3Client.send(command);
    res.json({ url, fields });
  } catch (err) {
    console.error(err);
    res.status(500).send('生成预签名失败');
  }
}

原因说明 #

S3的POST预签名机制要求：所有提交的表单字段（包括自定义元数据）必须在policy的conditions中明确声明，否则S3会拒绝请求或忽略未验证的字段。同时，表单上传的自定义元数据不能通过请求头传递——因为签名验证是基于表单字段生成的，请求头不在签名验证范围内，自然不会被S3识别为对象元数据。

内容的提问来源于stack exchange，提问作者002 DMAM Jigyasa Nagpal