使用AWS S3预签名URL上传文件时遇SignatureDoesNotMatch错误求助

我来帮你梳理下排查这个SignatureDoesNotMatch错误的关键思路，毕竟这个问题在预签名URL上传S3时挺常见的：

• 严格对齐前后端的Content-Type
  后端生成预签名URL时指定的Content-Type必须和前端上传时发送的完全一致，大小写、空格、后缀都不能错。比如后端设的是application/pdf，前端就不能写成application/PDF或者多打了空格，甚至不能漏传这个请求头。建议你直接把后端生成时用的Content-Type字符串原封不动传到前端，避免手动输入出错。

• 确保HTTP请求方法完全匹配
  后端生成预签名时用的是PUT还是POST？前端上传时必须用一模一样的HTTP方法。比如后端生成的是PUT类型的预签名URL，前端就不能用POST请求，这会直接触发签名不匹配。

• 检查是否有额外的请求头/参数
  如果后端生成预签名时还指定了其他参数（比如Cache-Control、x-amz-storage-class这类），前端上传时必须完整带上这些参数，且值要完全一致。另外要注意：前端框架或拦截器会不会自动添加额外的请求头（比如X-Requested-With）？这些未在预签名中声明的头会直接导致签名校验失败，建议上传时只保留预签名时指定的头。

• 验证预签名URL的完整性
  后端返回给前端的URL有没有被错误编码或截断？比如某些特殊字符被转义了。可以直接打印后端生成的URL和前端拿到的URL做对比，确保两者完全一致，没有任何额外的转义或修改。

• 检查服务器时间与签名有效期
  S3的签名校验对时间敏感，如果后端服务器的时间和S3服务器时间差超过5分钟，或者预签名URL的有效期设置得太短（比如几秒钟），都可能导致签名失效。可以先尝试延长有效期测试，同时确认后端服务器的时间是否同步。

• 用命令行验证预签名URL本身是否有效
  把后端生成的预签名URL拿出来，用curl或AWS CLI直接测试上传：

  curl -X PUT -H "Content-Type: application/pdf" --data-binary "@test.pdf" "你的预签名URL"
  

  如果这个命令能成功，说明后端生成的URL是没问题的，问题出在前端代码；如果命令也失败，那就要回头检查后端的预签名生成逻辑。

• 检查后端SDK的使用逻辑
  用AWS Java SDK（Kotlin）生成预签名时，要确保正确设置PutObjectRequest的Content-Type，比如：

  val putRequest = PutObjectRequest.builder()
      .bucket("你的桶名")
      .key("目标文件路径.pdf")
      .contentType("application/pdf")
      .build()
  val presignedUrl = s3Client.generatePresignedUrl(putRequest, Instant.now().plus(1, ChronoUnit.HOURS))
  

  同时确认SDK版本是否稳定，避免版本兼容性问题导致的签名生成错误。

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