介绍
跨域资源共享(Cross-Origin Resource Sharing, CORS) 。
配置项
CORS配置有以下几项:
- 来源(AllowedOrigin):允许跨域请求的来源,可以同时指定多个。配置时需带上完整的域信息,例如
http://10.100.100.100:8001
或https://www.aliyun.com
。注意, 不要遗漏了协议名http或https ,如果端口不是默认的80
,还需要带上端口。如果不能确定的域名,可以打开浏览器的调试功能,查看header中的Origin
。域名支持通配符*
,每个域名中允许最多使用一个*
,例如https://*.aliyun.com
。如果来源指定为*
,则表示允许所有来源的跨域请求。 - Method:按照需求开通对应的方法即可,调试时可以全部选择。
- Allow Header:允许的跨域请求header。允许配置多条匹配规则,以回车间隔。在Access-Control-Request-Headers中指定的每个header,都必须在Allowed Header中有对应项。Header容易遗漏,没有特殊需求的情况下,建议设置为
*
,表示允许所有。大小写不敏感。 - Expose Header:暴露给浏览器的header列表,即用户从应用程序中访问的响应头(例如一个Javascript的XMLHttpRequest对象)。不允许使用通配符。具体的配置需要根据应用的需求确定,只暴露需要使用的header。如果不需要暴露可以不填。大小写不敏感。该项是可选配置项。
- 缓存时间(MaxAgeSeconds):浏览器对特定资源的预取请求(OPTIONS请求)返回结果的缓存时间,单位为秒。如果没有特殊情况可以稍大一点,比如60秒。该项是可选配置项。
CORS的配置方法一般是针对每个访问来源单独配置规则,不将多个来源混到一个规则,多个规则之间不要有覆盖冲突。其它的选项只开放需要的权限即可。
错误排除
报错
CORS配置错误会报如下错误:
- 浏览器报类似如下错误:
OPTIONS http://bucket.oss-cn-beijing.aliyuncs.com/
XMLHttpRequest cannot load http://bucket.oss-cn-beijing.aliyuncs.com/. Response to preflight request doesn't pass access control check: No 'Access-Control-Allow-Origin' header is present on the requested resource. Origin '{yourwebsiet}' is therefore not allowed access. The response had HTTP status code 403.
- OSS报如下错误:
<Code>AccessForbidden</Code>
<Message>CORSResponse: This CORS request is not allowed. This is usually because the evalution of Origin, request method / Access-Control-Request-Method or Access-Control-Requet-Headers are not whitelisted by the resource's CORS spec.</Message>
提示:
- CORS报错一般是站点类应用导致,浏览器中可以查看请求详情。如Chrome,按
F12
打开开发者工具
,在Network
中查看相应元素;- OSS返回的错误可以通过抓包获取。如使用Wireshark,筛选器可以指定为
host bucket-name.oss-cn-beijing.aliyuncs.com
。
其它错误请参看 常见错误及排除。
排错
CORS可能错误如下:
来源(AllowedOrigin)
配置不正确;Method(AllowedMethod)
配置错误;Allow Header
配置错误;Expose Header
配置错误。
调试方法:
- 来源(AllowedOrigin)设置成
*
,确认该配置项无误。如果成*
后可以成功上传,说明是来源(AllowedOrigin)
配置错误,请根据规则认真检查; - Method(AllowedMethod) 全部选择(GET、PUT、DELETE、POST、HEAD) ,确认该配置项目无误;
- Allow Header配置成
*
,确认该配置无误; - Expose Header设置为指定值或者不填,确认该项配置无误。
提示:
- 在控制台的
对象存储OSS -> Bucket -> Bucket属性 -> 跨域设置
配置上述选项。