如何用AWS S3 JavaScript SDK生成带校验和验证的预签名POST请求

1. S3是否支持预签名POST的校验和验证？ #

支持，但需通过表单字段结合Policy条件约束实现，而非传统请求头方式。S3允许在预签名POST的Policy中指定预期校验和值，上传时客户端必须在表单中携带对应校验和字段，S3服务器会自动验证上传文件的校验和与预期值是否匹配，不匹配则直接拒绝请求。
注意：旧版Content-MD5在预签名POST场景中存在限制，推荐使用S3现代校验和字段（如x-amz-checksum-sha256）。

2. AWS JavaScript SDK是否支持添加预签名POST校验和验证所需的参数？ #

支持，推荐使用AWS SDK for JavaScript v3（依赖@aws-sdk/client-s3和@aws-sdk/s3-presigned-post包）。v3版本原生支持在createPresignedPost参数中配置校验和相关的Policy条件与表单字段；v2版本需手动构造Policy文档，配置成本更高，不推荐使用。

3. AWS JavaScript SDK是否支持指定校验和验证使用的算法？ #

支持。可指定的算法包括SHA256、SHA1、CRC32、CRC32C等，需在Policy条件中对应指定字段（如x-amz-checksum-sha256对应SHA256算法），同时在表单字段中传入该算法的预期校验值。

4. 示例代码（AWS SDK v3） #

第一步：安装依赖 #

npm install @aws-sdk/client-s3 @aws-sdk/s3-presigned-post

第二步：生成带校验和与大小限制的预签名POST #

import { S3Client } from "@aws-sdk/client-s3";
import { createPresignedPost } from "@aws-sdk/s3-presigned-post";

// 初始化S3客户端
const s3Client = new S3Client({ region: "your-region" });

async function generatePresignedPostWithChecksum() {
  const bucket = "your-protected-bucket";
  const key = "path/to/uploaded-file.ext";
  // 提前计算好的文件SHA256十六进制哈希值
  const expectedSha256Hash = "your-file-sha256-hash-hex";
  const minFileSize = 1024; // 最小上传大小：1KB
  const maxFileSize = 10 * 1024 * 1024; // 最大上传大小：10MB

  const { url, fields } = await createPresignedPost(s3Client, {
    Bucket: bucket,
    Key: key,
    Conditions: [
      // 限制文件大小范围
      ["content-length-range", minFileSize, maxFileSize],
      // 校验和匹配约束：上传文件的SHA256必须与预期值一致
      ["eq", "$x-amz-checksum-sha256", expectedSha256Hash],
    ],
    // 明确在表单字段中传入预期校验和值
    Fields: {
      "x-amz-checksum-sha256": expectedSha256Hash,
    },
    Expires: 3600, // 签名有效期1小时
  });

  console.log("预签名POST URL:", url);
  console.log("表单字段:", fields);
}

generatePresignedPostWithChecksum().catch(console.error);

客户端上传注意事项 #

• 提交表单时必须包含所有生成的fields键值对
• 确保上传文件的SHA256校验和与x-amz-checksum-sha256字段值完全一致（使用十六进制格式，无需Base64编码）
• 表单enctype必须设置为multipart/form-data

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