OBS 浏览器直传失败排查实战:从 CORS 预检到签名错误的六步流程

举报
yd_229207802 发表于 2026/11/02 09:31:23 2026/11/02
【摘要】 前端同学把图片直传到对象存储 OBS 时,最常见的一类问题就是浏览器控制台里的红字:No 'Access-Control-Allow-Origin' header is present,或者预检请求 OPTIONS 直接返回 403。这类问题几乎都出在跨域(CORS)规则上。本文整理一套我自己排查时用的顺序,每一步都能直接验证。一、先确认是预检失败还是正式请求失败打开浏览器开发者工具的 Ne...

前端同学把图片直传到对象存储 OBS 时,最常见的一类问题就是浏览器控制台里的红字:No 'Access-Control-Allow-Origin' header is present,或者预检请求 OPTIONS 直接返回 403。这类问题几乎都出在跨域(CORS)规则上。本文整理一套我自己排查时用的顺序,每一步都能直接验证。

一、先确认是预检失败还是正式请求失败

打开浏览器开发者工具的 Network 面板,看失败的是 OPTIONS 请求还是后面的 PUT/POST。浏览器在跨域且带自定义请求头(比如 Content-Type: application/json、Authorization 或 x-obs-* 头)时,会先发一次预检请求。预检不通过,正式请求根本不会发出,所以你在服务端日志里看不到任何上传记录,这是很多人排查时走偏的原因。

二、用 curl 模拟预检请求

直接在终端复现浏览器的预检:

curl -i -X OPTIONS "https://<桶名>.obs.<区域>.myhuaweicloud.com/test.jpg" \
  -H "Origin: https://www.example.com" \
  -H "Access-Control-Request-Method: PUT" \
  -H "Access-Control-Request-Headers: content-type"

正常情况下返回 200,并带有 Access-Control-Allow-Origin、Access-Control-Allow-Methods、Access-Control-Allow-Headers。如果返回 403,或者没有这些头,说明桶上没有任何一条规则匹配你这次请求的来源、方法和头域。

三、检查桶的 CORS 规则

在 OBS 控制台进入目标桶,找到“权限管理”下的“CORS规则”,逐项核对:

  • 允许来源:必须和浏览器地址栏里的 Origin 完全一致,包括协议和端口。https://www.example.com 与 http://www.example.com、https://www.example.com:8080 是三个不同的来源。测试阶段可先写 *,上线前收紧。
  • 允许方法:上传用到的 PUT、POST 要勾上,读取用 GET、HEAD。多段上传还会用到 POST 和 PUT 的组合,别只勾一个。
  • 允许头域:要覆盖前端实际发送的所有头。使用 Content-Type 就要写上 Content-Type,用预签名之外的鉴权就要包含 Authorization,用到 x-obs-acl 之类的头也要列出来。测试时可以先填 *。
  • 暴露头域:前端要读取响应头时必须声明。分段上传需要读取每一段的 ETag,如果没有把 ETag 加到暴露头域,浏览器里拿到的就是空值,合并分段时会报错。

保存后用第二步的 curl 再验证一遍。

四、中间有 CDN 时看缓存

如果域名走了 CDN 加速,浏览器访问的是 CDN 节点而不是 OBS。CDN 可能缓存了一份没有 CORS 头的响应,导致规则明明配了却一直不生效。需要在 CDN 的配置里为静态资源添加跨域相关的响应头,再刷新缓存后重试。判断方法很简单:把 curl 的地址换成 OBS 源站域名,如果源站有头、CDN 域名没有头,问题就在 CDN。

五、CORS 正常了还是 403?看签名

CORS 规则通过但上传仍然 403,这时要看响应体里的错误码,而不是继续改跨域:

  • SignatureDoesNotMatch:预签名 URL 生成时的 Content-Type 和浏览器实际发送的不一致,是最常见的原因。生成签名时用什么头,前端就必须原样带什么头。
  • RequestTimeTooSkewed:客户端或服务器时间与标准时间相差过大,校准系统时间即可。
  • URL 已过期:预签名链接有有效期,前端缓存了旧链接就会失败,每次上传前重新获取。
  • AccessDenied:签名所用账号没有该桶的写权限,检查桶策略与 IAM。

六、自检顺序

先看失败的是不是 OPTIONS,再用 curl 复现预检,核对来源、方法、头域,需要读响应头就加暴露头域,有 CDN 先比较源站与 CDN 的响应头,最后查签名与权限。大多数问题在前三步就能解决。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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