OBS 浏览器直传踩坑记:从 403 SignatureDoesNotMatch 到秒传成功

举报
yd_236978410 发表于 2026/11/13 08:53:22 2026/11/13
【摘要】 OBS 浏览器直传踩坑记:从 403 SignatureDoesNotMatch 到秒传成功最近在做一个小程序的后台上传功能,第一版把文件先传到自己的服务器、再由服务器转存 OBS,链路一长问题就全来了:接口超时、带宽打满、断点续传还得自己维护分片记录。改成浏览器直传 OBS 之后,整体延迟从 4 秒降到 400 毫秒左右。中间踩了几个坑,记下来备查。一、把预签名 URL 当成"一次性的"第...

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 和桶策略是两个独立开关。把这三条理顺,剩下的都是工程细节。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。