OBS 浏览器直传踩坑记:从 403 SignatureDoesNotMatch 到秒传成功
OBS 浏览器直传踩坑记:从 403 SignatureDoesNotMatch 到秒传成功
最近在做一个小程序的后台上传功能,第一版把文件先传到自己的服务器、再由服务器转存 OBS,链路一长问题就全来了:接口超时、带宽打满、断点续传还得自己维护分片记录。改成浏览器直传 OBS 之后,整体延迟从 4 秒降到 400 毫秒左右。中间踩了几个坑,记下来备查。
一、把预签名 URL 当成"一次性的"
第一版我让后端签好 PUT 链接直接返回,前端拿去用。测试时能传,过了一会儿就 403:
<Error><Code>AccessDenied</Code><Message>Request has expired</Message>
<RequestTime>2026-11-12T02:11:07Z</RequestTime><Expires>2026-11-12T02:01:00Z</Expires></Error>
原因很直白:预签名里带了 `X-Amz-Expires`,我给的 60 秒,用户选文件慢一点就过期。改成 15 分钟,同时在前端把"签名 → 上传"的距离压到最短:只在用户选中文件之后才去换签名,不做提前预取。
还有一个更隐蔽的变体:只要 URL 里的签名在有效期内,**同一个 URL 可以被重复使用任意次**,直到 key 不同为止。这和"一次性上传凭证"是两回事,别指望它防重放。
二、Content-Type 必须签名时定死
前端上传时习惯性加了 `Content-Type: image/jpeg`,结果又是 403:
<Code>SignatureDoesNotMatch</Code>
原因是 OBS 的 V4 签名把 `Content-Type` 纳入了 CanonicalHeaders。签名时没带这个头,上传时带了,签名串自然对不上。两种解法:
1. 后端签名时明确指定 Content-Type,前端上传时严格照抄;
2. 干脆不签 Content-Type(`content-type: ""`),前端也别设,让 OBS 走默认 `binary/octet-stream`。
我选了第一种,因为后面 CDN 回源要按 Content-Type 决定是否压缩,类型必须准。
注意一个容易漏的点:**带上 `x-amz-acl` 也必须一起签**,否则同样报 SignatureDoesNotMatch,而不是给你个权限错误。
三、CORS 配了但不生效
浏览器直传躲不过预检。我在桶的跨域设置里写了:
<CORSConfiguration>
<CORSRule>
<AllowedOrigin>*</AllowedOrigin>
<AllowedMethod>PUT</AllowedMethod>
<AllowedHeader>*</AllowedHeader>
<ExposeHeader>ETag</ExposeHeader>
<MaxAgeSeconds>3000</MaxAgeSeconds>
</CORSRule>
</CORSConfiguration>
结果 `OPTIONS` 还是 403。排查了半小时才发现:**预检请求本身不带签名**,走的是匿名身份,而我的桶策略只给 IAM 用户开了 `PutObject`,匿名身份在 CORS 阶段就被拒了。修法是把 CORS 规则和桶策略分开看——CORS 决定"浏览器允不允许发这个请求",桶策略决定"发过来给不给写",两个条件是 AND 关系,缺一不可。
另外 `ExposeHeader` 一定要写 `ETag`。前端拿不到 ETag 就没法做秒传校验,只能每次全量上传。
四、秒传:用 ETag 去重
大文件重复上传很浪费。标准做法是算文件内容的 MD5,先问后端有没有这个 MD5:
• 有 → 直接返回已有对象的 key,前端跳过上传;
• 没有 → 正常走签名上传,成功后把 MD5 和 key 的映射写库。
这里有个坑:**OBS 分片上传的 ETag 不是文件 MD5**,格式是 `md5-分片数`。只有单次 PUT 上传的对象 ETag 才等于内容 MD5。如果文件大于 5GB 走了分片,就不能拿 ETag 当内容指纹,得自己算 MD5 并存到对象元数据里。
我的处理是:小于 100MB 单次 PUT,ETag 直接当 MD5 用;大于 100MB 走分片,上传前先在前端用增量方式算一遍 MD5(分块读取 `File.slice()` 再喂给 SparkMD5),把结果作为自定义元数据带上,查询时读元数据而不是读 ETag。
五、几个收尾细节
• **文件名不要用原始文件名当 key**。中文、空格、`#`、`?` 都会让 URL 出问题,而且直传 URL 的 path 部分参与签名,前端编码方式不一致就是 SignatureDoesNotMatch。统一改成 `日期/uuid.后缀`,原始文件名放元数据里。
• **失败重试要带退避**。网络抖动时浏览器会瞬间重试,OBS 对同一 key 的并发 PUT 后写覆盖先写,容易出现内容错乱。我加了 500ms / 1.5s / 4s 三段退避。
• **上传进度用 `XMLHttpRequest.upload.onprogress`**,`fetch` 目前拿不到上传进度,只能拿下载进度。
• **校验放在服务端回调里做**,别信前端说的"已上传成功"。可以配 OBS 事件通知到 FunctionGraph,收到 `ObjectCreated` 后校验大小、类型,不合格直接删对象。
小结
浏览器直传 OBS 的核心就三句话:签名要短命但别太短、签了哪些头就必须原样发哪些头、CORS 和桶策略是两个独立开关。把这三条理顺,剩下的都是工程细节。
- 点赞
- 收藏
- 关注作者
评论(0)