前端页面请求阿里云上的接口、图片或文件时,浏览器可能提示“跨域请求被阻止”。这不一定代表网络不通:请求可能已经到达服务端,只是响应没有提供浏览器要求的跨域许可,页面因此无法读取结果。排查阿里云跨域问题,先确认请求最终由哪个服务响应,再到对应位置检查规则。只改前端代码,通常解决不了服务端响应头缺失的问题。
先确认跨域发生在哪一段
浏览器根据同源策略限制网页读取不同来源的资源。比如页面地址是 https://www.example.com,接口地址是 https://api.example.com,虽然两者协议相同,但域名不同,仍属于跨域。端口或协议不同,也会形成不同来源。
阿里云并没有一个适用于所有服务的跨域配置入口。请求可能由 OSS、ECS 上的应用、负载均衡、API 网关或 CDN 提供。先看浏览器里实际请求的域名,再沿着 DNS、代理和转发链路确认请求经过哪些组件、最终由谁返回响应。规则要配在能处理该请求并影响最终响应的服务上;如果只在链路中某个无关组件里添加规则,浏览器看到的结果不会改变。
三种常见场景,分别检查对应服务
OSS 图片、文件或网页资源
请求直接发往 OSS Bucket 域名时,通常需要在对应 Bucket 的跨域访问设置中添加规则。来源、方法和请求头要按实际页面填写。例如,文件只由 https://www.example.com 页面读取,就将这个站点设为允许来源,并按用途放行 GET、HEAD 等方法。
别因为测试方便就长期开放所有来源、方法和请求头。公开图片展示和带鉴权信息的文件上传,风险并不相同。上传时还要对照浏览器实际发送的请求头,确认是否会触发 OPTIONS 预检。OSS 跨域规则只影响浏览器能否读取响应,不能替代 Bucket 权限、签名或身份鉴权。
ECS 上的后端接口
如果接口运行在 ECS 上,由 Java、Node.js、Python 等应用提供,跨域响应通常要在应用或反向代理中处理。服务端需根据请求来源返回 Access-Control-Allow-Origin,并按实际请求设置允许的方法和请求头。请求携带 Cookie 或其他凭证时,还要明确允许凭证,并指定具体来源;这种情况下不能把允许来源设为 *。
代理和应用的配置也可能互相影响。比如 Nginx 与应用都添加了同名跨域响应头,浏览器收到的值可能重复或不符合预期;如果代理没有正确处理 OPTIONS,请求也可能在到达应用前失败。配置文件改完不算验证通过,要检查浏览器实际收到的响应头和状态码。
请求经过 CDN、负载均衡或网关
接入 CDN、负载均衡或 API 网关后,响应头可能在转发、缓存或规则处理时发生变化。建议分别检查源站和公网域名的响应,确认跨域头是否完整到达浏览器。源站配置已经更新、边缘节点仍返回旧结果时,可按产品配置刷新缓存或等待缓存过期。
如果服务会根据不同的 Origin 返回不同响应,也要检查缓存是否区分来源。否则,一个来源的响应可能被缓存后复用于另一个来源。是否需要调整缓存键或缓存策略,要结合所用产品和请求链路判断。
预检请求失败,实际请求就不会发出
部分简单 GET 请求不会触发预检;使用 PUT、DELETE 等方法,发送自定义请求头或特定类型的请求内容时,浏览器可能先发 OPTIONS,询问服务端是否允许后续请求。预检响应不符合要求,浏览器就不会继续发送实际请求。
遇到跨域报错时,在开发者工具的 Network 面板中筛选 OPTIONS,检查它的状态码和响应头。常见问题包括 OPTIONS 被网关或应用拒绝、允许方法没有包含实际方法、允许请求头漏配,或者代理把预检请求转发后返回了 404 等错误响应。只盯着 POST、PUT 等正式请求,容易错过真正失败的环节。
排查案例:OSS 配了规则,接口仍然报错
某团队的管理后台部署在 https://console.example.com,业务接口运行在阿里云 ECS,并通过 https://api.example.com 对外提供服务。页面提交数据时出现跨域报错,团队起初在 OSS 中添加了跨域规则,问题却没有变化。
检查浏览器请求后发现,出错地址是 API 域名,并不经过 OSS;由于请求带有自定义请求头,浏览器先发送 OPTIONS。预检请求经过反向代理后,被应用当成不支持的请求并返回 404。调整代理规则、让 OPTIONS 得到正确处理后,团队在接口响应中只允许管理后台的来源,并放行业务需要的方法和请求头。随后再检查实际 POST 响应,确认跨域头齐全,问题才解决。
这个场景里,OSS 规则本身未必有问题,只是配置在了错误的服务上。排查时要看具体请求落在哪个服务、预检经过哪些组件,不能只凭“资源在阿里云上”判断配置位置。
按请求链路逐项排查
- 看浏览器请求:在开发者工具中记录实际 URL、请求方法、状态码和响应头,同时确认有没有 OPTIONS 预检。
- 找出响应服务:判断请求由 OSS、ECS 应用、CDN、负载均衡还是网关处理;必要时对照 DNS 和代理转发配置。
- 核对允许范围:逐项检查来源、方法、请求头和凭证设置,确保与当前请求一致,并留意不同组件是否重复添加响应头。
- 检查缓存结果:对比源站和公网域名返回的响应。若两边不一致,检查 CDN 缓存,必要时刷新缓存并复核缓存策略。
- 用真实页面验证:从目标页面域名发起请求。命令行可以查看服务端响应,但不会替浏览器执行跨域限制,不能单独作为验收依据。
跨域报错也可能和鉴权或服务异常同时出现。接口返回 401、403 或 5xx 时,根因可能是身份验证、访问权限、源站故障或网络配置;浏览器的跨域提示有时只是让脚本无法读取真实错误。排查时把 Network 面板里的状态码、响应内容和控制台报错放在一起看,避免只盯着跨域提示修改规则。
上线前验证配置是否生效
生产环境只放行业务实际需要的来源、方法和请求头。确实需要 Cookie 或其他凭证时,使用明确的来源配置,并检查缓存行为;OSS 跨域配置不代替权限控制,接口跨域配置也不代替身份验证。
上线前至少用目标页面测试正常请求和预检请求,确认浏览器收到的响应头符合预期;如果业务涉及多个来源或 CDN 缓存,还要分别验证这些场景,并准备回滚方式。按“请求发到哪里、谁返回响应、浏览器缺少什么许可”逐项定位,比直接加通配规则更安全,也更容易发现配置到底有没有生效。