API地址直接打开正常,网站测速也是200,业务页面调用却报跨域错误,常见原因是检查对象不同。直接导航和后端HTTP请求都能拿到响应,并不意味着浏览器允许某个页面来源读取它。带自定义请求头或某些方法的跨来源调用,还可能先走一轮OPTIONS预检。

先通过蜘蛛模拟抓取请求公开接口 https://httpbingo.org/anything/cors-demo。工具普通GET取得200,这一轮没有模拟某个页面来源,也没有发送浏览器预检要求。它只能作为目标可返回普通响应的证据。

普通云端GET得到200,请求可达并不等于浏览器预检已经通过
普通云端GET得到200,请求可达并不等于浏览器预检已经通过

Origin需要与发起页面的来源对应

本地第一轮GET增加 Origin: https://example.com。响应返回200,并包含 Access-Control-Allow-Origin: https://example.com。公开接口回显的请求字段也确认收到了该Origin。本例使用虚构演示来源,没有登录Cookie,也没有向公共接口发送凭证。

Origin由方案、主机和端口组成,不是随便写一个页面完整路径。排查自己的应用时,应以浏览器实际发出的值为准;把 https://www.example.com 与 https://example.com 当成同一来源,或漏掉非默认端口,都可能导致允许列表与真实请求不匹配。

带Origin的GET收到对应允许来源,回显字段确认这轮实际发送的请求头
带Origin的GET收到对应允许来源,回显字段确认这轮实际发送的请求头

真正的预检会说明想做什么

第二轮显式发送OPTIONS,并加入三个字段:Origin、Access-Control-Request-Method: PUT 和 Access-Control-Request-Headers: x-demo。它表达的是“来自这个来源的页面,接下来想用PUT并发送x-demo头,是否被允许”。它没有提交真实PUT业务正文。

本次响应状态为200,正文为空,同时允许来源为演示来源,允许方法列表含PUT,允许请求头包含x-demo。截图中的这些头应与预检请求配对阅读,不能只看状态码。

OPTIONS预检响应同时列出允许来源、方法和x-demo请求头,正文为空不影响读取这些条件
OPTIONS预检响应同时列出允许来源、方法和x-demo请求头,正文为空不影响读取这些条件

如果服务器给OPTIONS返回了200,却没有匹配的允许来源、方法或请求头,浏览器仍可能不发出实际业务请求。反过来,看到OPTIONS并不是服务器被“多请求了一次”的异常,它可能是浏览器为跨来源访问执行的协议检查。

curl成功与浏览器通过仍然不同

curl可以帮助读取请求和响应头,但它不会替浏览器执行同源策略。本次命令行拿到两份响应,只能证明公开接口实际返回了这些字段,没有完成一个真实网页脚本的CORS端到端测试。浏览器还会根据请求模式、凭证设置和响应内容决定是否向脚本暴露结果。

带凭证的请求需要额外核对允许凭证与来源规则,不能把通配符来源当成对所有登录态调用都适用的写法。普通请求即便没有触发预检,其响应也仍需满足相应CORS读取条件,因而“Network里已经看到200”不能自动排除跨域问题。

先找失败发生在预检还是实际请求

在开发者工具Network中保留OPTIONS和实际请求,分别确认状态、Origin及允许头。若只有OPTIONS而没有后续PUT,应先检查预检条件;若实际请求已发出,再检查其响应是否也带了必要字段。登录跳转、网关错误页或异常分支漏加响应头,可能让失败只出现在部分结果上。

可以继续用网站测速检查接口可达性和普通状态,把连接问题与浏览器限制分别记录。工单里保留实际来源、方法、自定义头名称及两个阶段的原始响应,排查会比直接写“接口200但网络不通”更准确。本次演示没有修改任何生产跨域配置,也没有将公开接口的宽松允许策略当成业务站点配置建议。