网页从阿里云 OSS 加载图片、音频或文件时,浏览器提示“跨域请求被阻止”,问题通常出在 OSS 返回的 CORS 响应头与实际请求不匹配。改 JavaScript 或把 Bucket 改成公共读,未必能解决:公共读控制对象能否被访问,CORS 控制浏览器中的网页能否读取跨域响应,两者不是一回事。
排查阿里云oss 跨域时,先别急着改规则。打开浏览器开发者工具的 Network 面板,确认请求实际发往哪个 Bucket、用了什么方法和请求头,再对照控制台里的跨域规则。这样能避免把对象权限、域名配置或资源不存在误判成 CORS 问题。
先弄清楚:什么情况下会发生跨域
浏览器用“源”判断请求是否跨域。源由协议、域名和端口组成,其中任意一项不同,就属于不同源。例如网页运行在 https://www.example.com,请求的 OSS 地址是 https://demo-bucket.oss-cn-hangzhou.aliyuncs.com,由于域名不同,浏览器会进行跨域检查。
跨域报错不等于 OSS 文件不存在,也不一定说明网络请求完全没有发出。常见情况是控制台提示缺少 Access-Control-Allow-Origin,脚本无法读取响应内容,或者预检请求 OPTIONS 返回错误。直接把文件 URL 粘贴到地址栏能打开,也不能证明网页里的脚本可以读取它:地址栏访问和脚本跨域读取受到的检查不同。
阿里云 OSS 跨域配置步骤
- 确认实际请求的 Bucket 和域名。在页面代码或 Network 面板里查看请求 URL,确认资源由哪个 Bucket、地域节点或自定义域名提供。规则要配在实际提供资源的 Bucket 上;如果请求经过 CDN,也要继续检查 CDN 是否影响响应。
- 进入 Bucket 的跨域设置。登录阿里云 OSS 控制台,打开对应 Bucket,在数据安全或权限管理相关设置中查找跨域规则。控制台菜单名称可能随版本调整,可以在 Bucket 设置中搜索“跨域”。
- 填写发起请求的网页来源。来源是网页的地址,不是 OSS 地址。生产环境可填写 https://www.example.com,本地调试时按需加入 http://localhost:3000。协议、域名和端口都要与浏览器地址栏中的实际网页地址一致。
- 按业务需要选择方法。读取或加载资源通常涉及 GET、HEAD;上传可能使用 PUT 或 POST,删除则可能使用 DELETE。只开放代码实际使用的方法。浏览器发出的 OPTIONS 预检请求也要能通过对应规则,否则真正的请求可能还没发出就被拦下。
- 核对允许的请求头。如果请求带有 Authorization、Content-Type 或业务自定义请求头,检查它们是否在允许范围内。不要只因为 GET 测试成功,就认定上传请求也已经配置好。
- 设置需要暴露的响应头并保存。如果前端要读取 ETag、Content-Disposition 等非默认可读的响应头,需要把它们加入暴露响应头规则。保存后重新发起请求,并在 Network 面板确认响应头是否符合预期。
配置按实际需求收紧即可:只加业务要用的来源、方法和请求头。通配来源适合临时测试时评估问题,不宜直接当作生产环境的默认设置。涉及凭证的跨域请求时,也不能简单地把允许来源设为通配符;浏览器要求凭证请求的来源设置与凭证配置相匹配。
实际案例:图片能打开,Canvas 却读不到
某商品页部署在 https://shop.example.com,商品图片放在 OSS。用户直接打开图片 URL 没问题,但前端把图片绘制到 Canvas 后导出失败。这里容易误判:图片能够显示,只说明浏览器拿到了图片,并不代表脚本有权读取图片像素。Canvas 对跨域图片有额外限制。
排查时,先在 Network 面板确认图片来自哪个 Bucket,再把 https://shop.example.com 加入该 Bucket 的允许来源,并允许页面使用 GET 方法。前端加载图片时也要设置跨域属性,再设置图片地址;随后检查响应中是否有与网页来源匹配的 CORS 头。两边都符合要求后,Canvas 才能按预期读取图片内容。
这个场景里,只改 OSS 规则而不调整前端图片加载方式,问题可能仍在;只改前端代码,也不能代替 OSS 返回正确的 CORS 响应头。排查时把服务端规则和浏览器实际请求放在一起看,别只盯着其中一边。
跨域报错的常见排查方法
- 核对来源是否完全一致:HTTP 和 HTTPS 是不同来源,带端口和不带端口也不同。规则中写了主域名,不一定包含子域名;从测试环境切到正式域名后,也要检查来源是否更新。
- 检查请求方法和预检:GET 能成功,不代表 PUT 上传也能成功。遇到 OPTIONS 报错时,查看浏览器发出的预检请求及其响应,不要只检查后续的实际请求。
- 检查自定义请求头:Authorization、Content-Type 或业务自定义头可能触发预检。将实际发送的头与允许请求头逐项核对;添加新请求头后,重新测试对应请求。
- 区分 CORS 与对象权限:CORS 只控制浏览器是否允许网页读取跨域响应,不能给无权限用户开放私有对象。私有 Bucket 仍要通过签名 URL、授权或其他访问控制方式获取资源。
- 检查 CDN 和缓存:如果 OSS 前面接了 CDN,先确认浏览器请求实际经过哪一层。缓存中的旧响应可能还没有 CORS 头,可检查 CDN 缓存规则并按需刷新;也要避免不同来源的响应被错误地共用缓存。
- 以真实响应为准:在 Network 面板查看状态码、OPTIONS 请求和响应头。浏览器控制台的一句跨域提示,可能同时伴随权限错误、域名错误或对象不存在,不能只凭提示文字判断原因。
生产环境配置建议
上线时使用明确的来源白名单,别为了让报错消失就开放所有来源。方法和请求头也只保留业务实际需要的内容;测试域名不再使用后及时移除。如果页面要携带 Cookie 等凭证,确认前后端的凭证设置与允许来源彼此匹配,不要用通配来源绕过配置。
阿里云oss 跨域配置出错时,可以按顺序核对网页来源、实际请求方法、请求头、Bucket 和响应头,再用开发者工具验证。确定问题落在哪一层后再改对应设置,通常比直接放宽权限更容易定位,也能减少不必要的开放。