You need to enable JavaScript to run this app. AWS S3 Go SDK为预签名URL添加ACL后上传报签名不匹配错误
优惠活动
大模型
产品
解决方案
定价
更多

AWS S3 Go SDK为预签名URL添加ACL后上传报签名不匹配错误

预签名URL添加ACL后出现SignatureDoesNotMatch的解决方法

核心原因

S3预签名URL的签名校验逻辑非常严格:所有被列入X-Amz-SignedHeaders列表的请求头,必须由客户端在实际上传请求时原样携带,头名称、头值要和生成签名时的输入完全一致,任何偏差都会导致签名计算不匹配。
在PutObjectInput中新增ACL配置后,AWS SDK会自动执行两个关联操作:

  • 将设置的ACL值映射为x-amz-acl标准请求头(例如设置authenticated-read时,对应请求头为x-amz-acl: authenticated-read)
  • 将x-amz-acl加入X-Amz-SignedHeaders签名列表,也就是最终URL参数里看到的X-Amz-SignedHeaders=host%3Bx-amz-acl
    原有的curl上传命令没有携带这个新增的请求头,S3收到请求时检测不到对应头值、默认为空,计算签名的输入和生成URL时的输入存在差异,就会触发签名不匹配错误。
    从S3返回的报错信息可以直接印证这个问题:S3端用于比对的CanonicalRequest中,x-amz-acl:字段后为空,就是因为上传请求没有携带这个头。

正确实现方式

1. 调整上传请求携带匹配头信息

生成预签名URL的Go代码无需改动,只需要在执行curl上传命令时补上对应的ACL头即可:

curl -vT test.pdf -H "x-amz-acl: authenticated-read" '<<你的预签名URL>>'

如果是前端直传场景,需要在上传请求头中添加完全一致的x-amz-acl字段,避免漏传或者修改头值。

2. 排查SDK侧异常

代码中直接用req, _ :=忽略PutObjectRequest返回的错误,很容易遗漏参数校验类的异常。可以在生成预签名前打印请求头内容,确认ACL值被正确写入:

req, err := svc.PutObjectRequest(&s3.PutObjectInput{
    Bucket: aws.String(os.Getenv(BucketNameEnv)),
    Key:    aws.String(getFileName(file, customer)),
    ACL:    aws.String(s3.ObjectCannedACLAuthenticatedRead),
})
if err != nil {
    return nil, err
}
// 调试输出,确认x-amz-acl头值非空
fmt.Println("签名前请求头:", req.HTTPRequest.Header)

如果打印发现x-amz-acl值为空,可以直接手写头值替代常量,避免SDK版本中常量定义异常导致的空值问题:

ACL: aws.String("authenticated-read")

此前尝试无效的原因

  • 拼写错误:将x-amz-acl写为x-amc-acl,头名称不符合S3规范,S3会忽略这类自定义头、不将其纳入签名计算,自然无法匹配校验
  • 自定义host头为127.0.0.1:host是S3签名的必选头,生成URL时使用的是S3正式域名,发请求时修改host值会导致两边的签名计算输入完全不一致,必然报错
  • 手动修改预签名URL的X-Amz-SignedHeaders参数:URL中的所有查询参数都是签名计算的输入,手动替换参数值(包括将编码分号改为未编码格式、修改头名称)会直接篡改签名的计算依据,且修改时依然存在x-amz-acl拼写错误的问题,完全无法生效

可选优化方案

如果不希望客户端额外携带请求头,可以调整实现逻辑:

  • 直接在S3桶上配置对象默认ACL,设置所有上传对象的默认权限为authenticated-read。此时生成预签名URL时不需要在代码中添加ACL参数,签名列表里不会额外增加x-amz-acl,客户端可以直接上传,和最初的无ACL场景体验完全一致
  • 尽量减少预签名请求中需要额外签名的头,降低客户端的传参成本

内容的提问来源于stack exchange,提问作者victorpacheco3107

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.30 02:54:02