前端页面从一个域名请求另一个域名上的资源时,浏览器可能拦截请求并提示跨域错误。资源如果存放在阿里云对象存储OSS,通常需要配置CORS(跨域资源共享),明确允许哪些网站发起请求、使用哪些方法,以及携带哪些请求头。
配置前先确认资源所在的地域和Bucket。CORS规则要设置在实际提供资源的Bucket上,域名、来源和请求内容也要与前端实际发出的请求对应。控制台页面名称可能随版本调整,可在Bucket管理页面的权限或数据管理相关区域查找跨域设置。
CORS解决什么问题
假设页面运行在 https://www.example.com,图片或接口资源位于 https://assets.example-oss.com,浏览器会把它们视为不同源。浏览器是否允许页面读取OSS返回的内容,要看响应中是否包含符合要求的跨域许可信息。
CORS不负责开放Bucket,也不能代替身份验证和权限控制。它控制的是指定来源下的浏览器请求能否读取响应。Bucket仍应按业务设置访问权限;如果文件是私有的,应使用签名URL等方式控制访问。收到403时,单纯放宽CORS规则通常解决不了问题。
阿里云CORS设置的5项检查
- 确认目标Bucket。登录阿里云控制台,打开对象存储OSS,选择存放资源的Bucket,并核对地域和名称。常见的配置失误是规则加在了另一个Bucket上,页面看起来已保存,实际请求却仍然跨域失败。
- 找到跨域规则页面。进入Bucket管理页面,在权限管理或数据管理相关区域打开跨域设置(CORS),创建规则。填写时,按实际请求整理来源、允许方法、允许请求头和暴露响应头,不要只凭页面功能猜测需要开放哪些项。
- 核对来源Origin。来源通常由协议、域名和可选端口组成,例如
https://www.example.com。这里不填写页面路径;http和https是不同来源,开发地址上的端口也需要匹配。开发和正式环境可以分别添加,例如http://localhost:3000与https://www.example.com。生产环境应避免无差别放开所有来源。 - 只开放实际使用的方法和请求头。根据请求勾选GET、HEAD、PUT、POST等方法。带自定义请求头或特定内容类型的请求可能先触发OPTIONS预检,OSS需要能正确处理预检。若控制台没有单独的OPTIONS选项,应按控制台规则配置实际请求方法。允许请求头可填写前端确实发送的字段,例如
Content-Type、Authorization或自定义头。配置太窄会让预检失败,配置太宽则会放大允许范围。 - 检查暴露响应头和缓存时间。浏览器脚本默认不能读取所有响应头。前端需要读取
ETag或自定义下载文件名响应头时,应将对应字段加入暴露响应头。预检缓存时间可按业务调整:调试时设得短一些,规则稳定后再考虑延长。保存规则后,重新发起请求验证。
按业务场景收紧规则
如果官网只需要展示OSS中的图片,并读取图片响应信息,可以将来源设为官网域名,方法按实际情况选择GET和HEAD,再填写前端需要读取的响应头。单纯加载公开图片通常不需要开放PUT、POST,也不必允许与请求无关的Authorization等头字段。
如果前端要上传文件,就要根据上传流程开放必要的方法和请求头,同时限制来源为可信页面域名。请求需要携带Cookie或其他凭证时,还要检查前端是否启用了凭证模式,以及OSS返回的响应是否允许凭证。此类请求不能使用允许任意来源的配置,必须返回明确的来源域名。上传和展示图片的规则不必相同,分清场景有助于避免权限范围过大。
遇到跨域错误时的排查顺序
- 规则已保存,浏览器仍然报错:先核对请求实际访问的域名是否对应当前Bucket,再逐项比较来源的协议、域名和端口。只差一个协议或端口,浏览器也会认为来源不匹配。
- GET正常,上传或带自定义头的请求失败:打开浏览器开发者工具的Network面板,检查失败请求前是否出现OPTIONS预检,并查看它的状态码和响应头。随后核对方法、
Content-Type、Authorization等是否在允许范围内。 - 前端拿不到响应头:确认目标字段是否加入暴露响应头。响应里有
ETag,不代表页面脚本就能直接读取;需要在CORS规则中明确开放给浏览器脚本。 - 修改规则后结果不一致:检查浏览器缓存、预检缓存,以及请求是否经过CDN或代理。可以先直接请求OSS域名作对比;直连正常、经过CDN异常时,再检查CDN缓存和回源配置是否影响响应头。
- 请求返回403:不要先扩大CORS规则。检查Bucket和对象的读写权限、签名URL是否过期,以及请求签名是否正确。CORS只处理浏览器跨域读取,不会让原本无权访问的私有文件变成可访问。
上线前逐项验证
部署前使用正式页面域名测试实际业务:图片能否读取,文件能否上传或下载,前端需要的响应头能否拿到。再检查来源列表是否只包含可信域名,方法和请求头是否仅开放必要项,以及请求是否启用了凭证。
排查时以Network面板里的请求和响应为准,先分清是CORS拦截、权限拒绝,还是资源不存在。把这几类问题分开处理,能避免为了修复一个权限错误而放宽跨域规则,也能让阿里云CORS设置更贴合实际业务。