OBS 浏览器直传失败排查实战:从 CORS 预检到签名错误的六步流程
前端同学把图片直传到对象存储 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 的响应头,最后查签名与权限。大多数问题在前三步就能解决。
- 点赞
- 收藏
- 关注作者
评论(0)