精选优惠 · 官方会场

轻量应用服务器

新用户专享

2核2G · 200M峰值带宽 · 40G系统盘

限阿里云新用户
68元/年限阿里云新用户
立即选购

云服务器 ECS

新老同享

经济型e · 2核2G · 3M固定带宽 · 40G盘

同主体限1台 · 不可叠券
99元/年同主体限1台 · 不可叠券
立即选购

云数据库 RDS

数据库精选

托管数据库 · 弹性扩容 · 自动备份

按地域与配置选择
查看活动价按地域与配置选择
查看优惠
更多阿里云活动收起阿里云活动
11月1日—30日企业至高减 1728 元

双11满减礼包

个人至高减360元;需对应实名认证,满减门槛及适用产品以官方规则为准。

前往官方会场
AI 专场让 AI 应用轻松上云

AI 产品特惠

浏览 Token Plan、Qoder 与 AI 应用等官方活动,按实际使用需求选择。

前往官方会场
搭配更省心服务器 + 数据库

云产品组合购

查看 ECS、RDS 等组合活动,按业务规模和实际预算搭配。

前往官方会场
官方活动合集热门云产品,一站选

云小站更多特惠

继续查看服务器、数据库与存储等优惠,选择适合自己的配置。

前往官方会场

阿里云 OSS 跨域配置原理与常见问题排查方法

网页从一个域名读取阿里云 OSS 中的图片、字体或文件时,如果页面和资源的协议、域名或端口不同,浏览器就会按跨域请求处理。文件能直接打开,不代表网页里的 JavaScript 一定能读取它;浏览器还会检查响应中的跨域资源共享(CORS)信息。

阿里云 OSS 跨域配置的作用,是告诉浏览器哪些页面来源可以发起请求、哪些方法和请求头可以使用,以及前端能读取哪些响应头。它不负责授予文件访问权限:私有 Bucket 仍需通过签名 URL 或其他有效凭证访问,CORS 配置不会让未授权用户自动拿到文件。

配置前先确认请求经过哪里

排查时先在浏览器开发者工具的 Network 面板里找到失败请求,记下完整 URL、请求方法和 Origin。请求可能走 OSS 默认域名,也可能经过自定义域名、CDN、反向代理或重定向。浏览器检查的是最终收到的响应,因此源站规则正确,并不保证 CDN 返回的响应也带有正确的 CORS 响应头。

也要分清请求发生在哪里。服务器调用 OSS 通常不受浏览器同源策略限制;只有浏览器发起跨域请求,且页面需要读取响应时,CORS 才是主要排查方向。若是服务端请求报错,应继续检查服务端日志和访问凭证,别只改 Bucket 规则。

OSS CORS 规则需要匹配哪些内容

  • 允许的来源(Allowed Origins):对应发起请求的页面来源,通常由协议、域名和端口组成。生产环境应填写实际站点地址;测试和生产域名可以分别管理,避免把测试来源长期留在生产规则里。
  • 允许的方法(Allowed Methods):按业务需要设置 GET、HEAD、PUT 或 POST 等方法。前端直传文件常用 PUT 或 POST;浏览器需要先发 OPTIONS 预检时,也要检查预检是否能获得符合规则的响应。
  • 允许的请求头(Allowed Headers):规则要覆盖请求实际使用的头,例如 Content-Type、Authorization 或自定义头。浏览器在预检请求的 Access-Control-Request-Headers 中会列出所需请求头,可用它核对配置。
  • 暴露的响应头(Expose Headers):若前端 JavaScript 需要读取 ETag 等响应头,应将其加入暴露列表。没有配置时,响应头可能存在,但页面脚本仍无法读取。
  • 预检缓存时间(Max Age):浏览器可在设定时间内复用预检结果,减少重复 OPTIONS 请求。修改规则后,旧的预检缓存可能暂时影响测试结果。

规则按实际需求收窄即可:不要为了让一次请求通过,就把所有来源、方法和请求头都开放。尤其是多个环境共用 Bucket 时,逐项确认哪些域名和请求方法确实需要访问。

在控制台添加跨域规则

  1. 登录阿里云控制台,进入对象存储 OSS,打开需要配置的 Bucket。
  2. 找到跨域设置(CORS),新增一条规则。
  3. 填写允许的来源、方法、请求头、暴露响应头和预检缓存时间,范围与业务请求保持一致。
  4. 保存后,从实际页面重新发起请求,在 Network 面板检查 OPTIONS 预检和后续请求的状态及响应头。

控制台入口或字段名称可能随版本调整,判断配置是否生效,不能只看规则是否保存。要确认浏览器发出的 Origin、请求方法和请求头能匹配规则,也要检查最终响应是否经过了正确的服务链路。

案例:前端直传文件时 OPTIONS 失败

某电商后台运行在 https://admin.example.com,商品图片存放在 OSS。前端先向后端获取签名 URL,再用 PUT 将文件直传到 Bucket。测试时,图片下载正常,上传却报跨域错误。检查请求后发现,浏览器在 PUT 前发送了 OPTIONS 预检,而 Bucket 规则只覆盖 GET,也没有放行上传请求实际使用的 Content-Type。

处理时,团队将管理站点的来源加入规则,开放业务需要的 PUT 方法,并按实际请求补齐允许的请求头。随后又检查了 CDN 和自定义域名链路,确认中间层没有移除 OSS 返回的 CORS 响应头。预检通过后,浏览器才继续发送 PUT,上传恢复正常。

这个场景里,签名 URL 和 CORS 解决的是两件事:签名用于验证请求是否有权限访问 OSS,CORS 用于决定浏览器是否允许页面完成跨域交互。两项条件都要满足,不能拿其中一个替代另一个。

常见错误及排查方法

Origin 和实际页面地址不一致

Origin 通常包含协议、域名和非默认端口。http 与 https 不同,带端口和不带端口也可能不匹配。不要凭印象填写来源,直接查看请求头中的 Origin,再与规则逐项核对。

只看 PUT 或 POST,漏查预检

请求使用 PUT,或带有自定义请求头时,浏览器可能先发送 OPTIONS。先检查这条预检请求的状态码和响应头;如果它没有通过,后续实际请求通常不会发出。此时只盯着 PUT 报错,容易把问题归到签名或文件内容上。

前端新增请求头后规则失效

加入 Authorization、自定义业务头,或更改 Content-Type 后,原有规则可能不再适用。查看预检请求里的 Access-Control-Request-Headers,确认浏览器要求允许哪些头,再据此调整规则。

把 CORS 当成文件权限

CORS 不是防止资源被下载的权限控制。资源不应公开时,应使用私有读权限和签名访问,并在服务端妥善管理凭证。需要携带 Cookie 或其他凭证时,也不要随意使用通配来源;来源和响应配置必须符合浏览器要求,并限制在业务所需范围内。

缓存或 CDN 让新规则看起来没生效

浏览器可能缓存预检结果,CDN 也可能缓存响应。可以用无痕窗口辅助验证,并分别对比 OSS 源站和 CDN 域名的响应头。如果源站正常、CDN 路径失败,就检查 CDN 的缓存策略、回源行为和响应头转发设置。

上线前检查

  • 浏览器实际发送的 Origin 与允许来源匹配,协议、域名和端口都正确。
  • 规则只开放业务需要的方法和请求头,前端直传场景已检查 OPTIONS 预检。
  • 需要由 JavaScript 读取的响应头已加入暴露列表。
  • 私有文件仍通过签名或其他授权方式访问,没有用 CORS 代替权限控制。
  • 经 CDN 或自定义域名访问时,已核对浏览器最终收到的响应头。

阿里云 OSS 跨域排查可以从浏览器实际请求开始:先看 Origin 和 OPTIONS 预检,再核对请求头、响应头以及 CDN 等中间链路。确认具体是哪一项不匹配后再调整规则,通常比直接放宽权限更省事,也更稳妥。

赞 (0)
上一篇 2026年11月15日 上午2:31
下一篇 2026年11月15日 上午2:31

相关推荐

  • 阿里云幕布打印怎么设置?导出文件和纸张选择要点

    搜索“阿里云幕布打印”,通常是想把幕布里的思维导图、课程提纲或工作计划打印成纸质资料。这里要分清两件事:幕布负责编辑和整理内容,阿里云一般用于存储或分享文件,并不是幕布文档的专用打印入口。常见流程是先在幕布中导出文件,再用电脑或手机上的阅读器设置纸张并打印;文件要交给别人或在不同设备间流转时,才需要考虑阿里云存储服务。 先确认文档和文件分别在哪里 文档还在幕…

    阿里云 2026年11月15日
  • 阿里云os应用市场有哪些应用?部署前要看什么

    搜索“阿里云OS应用市场”,可能是在找终端设备上的应用入口,也可能是想为云服务器选软件,或了解阿里云操作系统相关产品。几种需求看起来接近,实际对应的产品和安装方式并不一样。先确定应用要运行在哪里,比直接点开搜索结果更省时间。 产品名称、上架范围和访问入口可能随服务调整。涉及具体系统版本、设备型号或地域时,应以阿里云官方页面、产品文档及设备厂商说明为准。尤其是…

    阿里云 2026年11月15日
  • 阿里云无线服务器怎么选?接入方式和部署要点详解

    “阿里云无线服务器”容易让人以为是能直接提供 Wi-Fi 的产品。实际选型时,先要分清两件事:无线网络负责让设备连上网,云服务器负责运行应用、接收数据和处理请求。阿里云 ECS 是云端计算资源,本身不提供 Wi-Fi 热点,也不能替代无线路由器或运营商网络。 搜索阿里云无线服务器,常见需求大致有两种:让手机、电脑通过无线网络访问部署在云上的业务,或将摄像头、…

    阿里云 2026年11月15日
  • 阿里云地址在哪找?官网入口和控制台位置怎么看

    搜“阿里云地址”的人,通常要找三样东西:官网怎么进,控制台怎么登,服务器或服务放在哪个地域。这三样的入口和用途各不相同。分清楚以后,能少绕弯路,也少碰上仿冒页面。 官网和控制台分别在哪 阿里云中国站的官网域名是 aliyun.com。直接在地址栏输入,或从搜索结果进入时仔细核对链接,是最稳的做法。另外几个常用入口如下: 控制台:console.aliyun.…

    2026年10月31日
  • 阿里云分布式事务怎么选?跨服务数据一致性实战要点

    Seata、DTS、RocketMQ 事务消息到底怎么选?这篇文章以电商下单为例,把原理、用法和容易踩的坑一起讲清楚。 一、单体时代不用想的问题 单体应用里,下单、扣库存、扣余额、生成订单通常放在同一个本地数据库事务里,成功就一起成功,失败就一起回滚,基本不用额外操心。服务拆开之后,这四步落在不同的服务和数据库上,本地事务管不到那么远,原子性也就没了。 比如…

    2026年11月1日
返回顶部