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
相关产品推荐
相关产品推荐

