使用预签名URL上传至S3失败，请求解析报错求助

错误原因分析 #

这个错误本质是请求格式不符合LocalStack S3的解析要求，常见触发场景包括：

• 预签名URL生成错误：比如误使用getObject等其他操作生成签名，或者Bucket/Key参数拼写错误，导致LocalStack无法识别请求对应的操作。
• 请求体异常：PUT请求没有携带请求体（或请求体格式完全不符合预期），LocalStack错误地将其当作XML格式请求解析，从而抛出无效XML的错误。
• 请求头不匹配：生成预签名URL时指定了Content-Type等必填请求头，但实际PUT请求未携带对应头，导致签名验证失败，进而触发解析错误。
• LocalStack版本兼容问题：旧版本LocalStack的S3模拟模块存在请求解析BUG，对预签名PUT的处理逻辑不完善。

解决步骤 #

• 验证预签名URL生成逻辑：确保使用putObject操作生成签名，且Bucket、Key参数正确，示例代码：

  const AWS = require('aws-sdk');
  const s3 = new AWS.S3({ endpoint: 'http://localhost:4566' }); // LocalStack端点
  const signedUrl = s3.getSignedUrl('putObject', {
    Bucket: 'test-bucket',
    Key: 'test-file.txt',
    Expires: 3600
  });
  

• 确保PUT请求携带合法请求体：即使上传空文件，也要保证请求体长度为0（而非完全无请求体），可通过curl测试：

  curl -X PUT -d "" "你的预签名URL"
  

• 匹配预签名时的请求头：如果生成预签名时指定了Content-Type等头，实际请求必须携带对应头。比如生成时指定了ContentType: 'image/png'，请求时要加上-H "Content-Type: image/png"参数。
• 升级LocalStack到最新稳定版：通过pip install --upgrade localstack或Docker拉取最新镜像，修复旧版本的解析BUG。
• 确认请求方法：确保发送的是PUT请求，而非GET或其他方法。

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