前端页面读取阿里云OSS上的图片、音频或文件时,浏览器可能提示请求被CORS策略阻止。文件本身未必有问题,地址也可能没有写错;常见原因是网页和OSS资源不属于同一个来源,而OSS返回的跨域响应没有满足浏览器的要求。
配置CORS只是在浏览器跨域访问这一步放行请求,不会改变Bucket或对象的读写权限。私有文件仍需相应授权,公开可读的对象也不代表网页脚本一定能读取它。
阿里云OSS跨域是怎么判断的
浏览器用“源(Origin)”判断两个地址是否同源。源由协议、域名和端口组成。例如,网页来自 https://www.example.com,资源来自 https://my-bucket.oss-cn-hangzhou.aliyuncs.com,两者来源不同,浏览器就会检查跨域响应。
跨域请求通常会带上Origin。OSS需要在响应中返回符合规则的信息,浏览器才会把响应内容交给网页脚本。若请求使用自定义请求头,或采用PUT、DELETE等非简单请求方法,浏览器通常还会先发送OPTIONS预检请求。规则没有覆盖网页来源、请求方法或请求头时,预检或实际请求就可能失败。
排查前先核对这三项
- 核对Bucket:根据资源URL确认对象属于哪个Bucket,避免把规则加到另一个Bucket。请求如果经过自定义域名或CDN,也要确认实际访问链路。
- 核对网页Origin:在浏览器开发者工具中查看请求的Origin,连同协议、域名和端口一起记录。http://localhost:3000与http://localhost:5173是两个不同来源。
- 核对请求内容:确认请求方法、前端发送的自定义Header,以及脚本是否需要读取ETag等响应头。仅凭控制台的一句报错,很难判断该改哪项规则。
在控制台配置阿里云OSS跨域
进入阿里云OSS控制台,选择对应Bucket,打开跨域设置(CORS)并新增规则。控制台界面名称可能会调整,配置时主要核对以下几项:
- 来源(Allowed Origin):填写允许访问的网页来源,例如https://www.example.com。要带上协议,通常不填写页面路径。开发环境和生产环境可以分别添加。
- 允许的方法(Allowed Method):按业务实际选择GET、HEAD、PUT、POST或DELETE等。只读取图片通常用GET;上传文件时,再根据上传请求选择PUT或POST。
- 允许的请求头(Allowed Header):规则要覆盖前端实际发送的请求头。若请求中带有Authorization、Content-Type或自定义Header,应检查它们是否被允许。通配符配置较省事,生产环境仍建议收窄到业务需要的范围。
- 暴露的响应头(Expose Header):浏览器脚本默认不能读取所有响应头。代码需要获取ETag或Content-Disposition时,要把对应Header加入暴露列表。
- 缓存时间(Max Age):该项用于设置浏览器缓存预检结果的时间,可以减少OPTIONS请求。修改规则后,浏览器可能还在使用缓存的预检结果;排查时可清理缓存,或稍后再试。
保存后,打开浏览器开发者工具的网络面板,分别检查OPTIONS预检请求和实际请求的状态及响应头。CORS规则与Bucket访问权限是两套控制:来源获准,不代表私有对象无需授权;对象公开可读,也不代表浏览器会允许网页脚本跨域读取。
图片能打开,页面代码却读取失败
例如,某团队把商品图片存放在OSS,网页部署在https://shop.example.com。把图片地址复制到浏览器地址栏后可以正常显示,但页面通过JavaScript加载时出现跨域错误。
检查后发现,Bucket读权限正常,CORS规则却只允许测试来源http://localhost:5173,没有包含正式站点。团队为规则补上生产域名,并将允许方法设为GET和HEAD,只保留页面实际需要的请求头,图片读取随后恢复正常。
后来代码需要读取ETag,图片仍能显示,脚本却拿不到这个响应头。原因是ETag没有加入暴露列表。补上对应的Expose Header后,脚本才可以读取它。图片能显示和脚本能读取响应头,属于两个不同的问题。
常见跨域报错怎么查
Origin看起来没问题,浏览器仍然拦截
逐项比对协议、端口和子域名。https://example.com、http://example.com与https://app.example.com并不相同。还要确认请求实际访问的Bucket和域名,避免在错误的Bucket上修改规则。
GET正常,上传或带Header的请求失败
先看网络面板中的OPTIONS请求。若预检失败,检查规则是否允许当前请求方法和实际发送的Header。前端带了自定义Header时,只允许GET通常不够。不要为了消除报错就开放所有方法,按请求需要配置即可。
地址栏能打开文件,网页代码却报跨域
地址栏直接访问只能说明资源可以打开,不能证明浏览器允许脚本读取跨域响应。查看网络请求及响应头更有用。如果请求经过CDN,也要检查CDN缓存或回源配置是否影响CORS响应。
保存规则后,报错没有马上消失
先确认规则保存到了正确的Bucket,再清理浏览器缓存、等待预检缓存过期后重试。无痕窗口也可以用来排除本地缓存干扰。
上线前别把CORS当成权限控制
开发时可以临时加入本地调试域名,上线后应改为明确的生产来源。只开放业务要用的方法和请求头,不要依靠CORS保护敏感文件;这类文件仍应配合私有读权限、签名URL或后端授权。使用Cookie等凭证时,还要核对客户端凭证设置与服务端来源规则,不能直接套用任意来源的通配配置。
阿里云OSS跨域配置后仍报错,可以先从实际Origin和请求链路查起,再核对方法、请求头及需要暴露的响应头,最后分别验证OPTIONS和实际请求。把跨域放行与对象权限分开检查,通常比反复修改宽泛规则更容易找到问题。