You need to enable JavaScript to run this app. DigitalOcean Spaces预签名URL上传设置public-read ACL后文件仍为私有
优惠活动
大模型
产品
解决方案
定价
更多

DigitalOcean Spaces预签名URL上传设置public-read ACL后文件仍为私有

问题根因
  • DigitalOcean Spaces的预签名PUT上传权限逻辑为:服务端仅从浏览器实际发出的PUT请求的HTTP头中读取ACL配置,不会根据预签名URL生成阶段的后端参数,自动为上传完成的文件赋予公开权限。
  • 你所使用的AWS SDK v3 3.8.0版本,在生成预签名URL时,虽然会把PutObjectCommand中配置的ACL: 'public-read'纳入签名计算范围,但不会将该配置对应的x-amz-acl请求头设为强制校验项。这就导致你的前端请求即便不携带该头,也能通过签名校验完成上传;但由于请求本身没有携带任何ACL标识,Spaces会直接按照Bucket的默认私有规则,将新上传的文件设置为私有状态。
  • 你在控制台手动调整文件权限后可以正常访问,是因为手动操作直接触发了服务端的权限写入流程,不存在请求头传递缺失的问题。
修复方案
  • 核心调整:在前端发起上传请求时,显式携带与后端配置完全匹配的ACL请求头,保证ACL值能真正传递到Spaces服务端。
  • 调整后的前端上传代码:
const uploadResponse = await fetch(url, {
    headers: {
        'Content-Type': file.type,
        'Cache-Control': 'public,max-age=31536000,immutable',
        // 显式携带与后端ACL配置匹配的请求头
        'x-amz-acl': 'public-read'
    },
    body: file,
    method: 'PUT',
})
  • 额外校验注意事项:
    • 前端携带的x-amz-acl取值必须和后端PutObjectCommand里配置的ACL值完全一致,否则会直接触发签名校验失败
    • 检查你使用的DigitalOcean Spaces API密钥的权限范围,确保密钥拥有修改对象ACL的权限,避免因密钥权限不足被服务端强制将文件设为私有
    • 后端生成预签名URL时,不要配置和前端实际请求不匹配的请求头,否则会直接阻断上传流程

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.31 15:06:08