李涛自留地
回到顶部
首页 > 前端 > 前端解决跨域从哪里开始查?从请求头到代理的顺序

前端解决跨域从哪里开始查?从请求头到代理的顺序

文章目录

同样是调一个接口,前端解决跨域的两条路走出来结果完全相反:一个页面把 Access-Control-Allow-Origin 写成星号,接口通了;另一个页面在本地加了一层转发,也通了。差别在于第一个页面只要带上 cookie 就报 CORS 错误,第二个从头到尾没出现过一次跨域提示。两边后端是同一份代码,改的只是请求从哪个地址发出去。真要排查,先分清是请求头没带对、响应头没给全,还是这条路根本没走同源。

排查顺序:请求头 → 响应头 → 代理,倒着查会绕远路

打开开发者工具的 Network 面板,选中报错的那条请求,按三个位置依次看。Request Headers 里确认 Origin 是不是当前页面地址、Cookie 有没有随请求发出去;Response Headers 里找 Access-Control-Allow-Origin,看这一行在不在、值是不是那个 Origin;两处都对不上,才轮到构建工具或 nginx 的转发规则。先去改代理再刷新,页面还是同样的报错,因为问题从来不在那一层。

浏览器先发预检、服务端再回响应头的三段链路

Origin 在同源 GET 里确实不出现,但同源的 fetch POST 照样会带上。所以判断跨域看的是它跟当前页面地址一不一致,不是它在不在。真跨域的请求里连 Origin 都看不到,说明浏览器压根没把这条当跨域处理,后面那些字段也就不用找了。

报错原文先说清是哪一类:

Access to fetch at 'https://api.example.com/user' from origin
'http://localhost:5173' has been blocked by CORS policy:
No 'Access-Control-Allow-Origin' header is present on the
requested resource.

这段的意思是:请求发出去了,服务端也回了,只是回的那份响应里没有这个头。换成 Request header field authorization is not allowed by Access-Control-Allow-Headers,缺的就是 Allow-Headers 那一行;换成提到 credentials 的字样,问题在通配符和凭据不能共存。

三步走完,控制台给的每一句话都能落到某个具体字段上。

预检让一次请求变成两次

Content-Type 设成 application/json,或者请求里带了 Authorization,浏览器就不会直接发。它先发一条 OPTIONS,把 Access-Control-Request-Method 和 Access-Control-Request-Headers 报给服务端,等服务端点头,才发真正的 POST。

表单那两种类型,application/x-www-form-urlencoded 和 multipart/form-data,按规范算简单请求,不触发预检。同一个接口换一种提交方式,Network 里就少一条 OPTIONS,报错也跟着消失——这时候该改的是服务端收不收这种格式,不是跨域那几行。

这条 OPTIONS 在 Network 面板里单独占一行,状态码通常是 204 或 200,Response Headers 为空的时候最容易被忽略。

五个响应头字段自上而下叠放的层级结构

用 curl 手发一条同样的 OPTIONS,返回可能是 200,浏览器那边照样报预检失败。这一步的判断是浏览器做的,它读的是响应头里那几行,不是状态码。

想让 curl 模拟出同样的预检,得手动加 -H 'Origin: http://localhost:5173' 和 -H 'Access-Control-Request-Method: POST'。少了这两个头,服务端回的是一份普通响应,看着一切正常。

所以预检失败和请求失败要分开看。前者说明服务端没答应这次跨域,后者说明答应了但业务本身出错,两个方向的处理完全不同。

服务端补响应头,预检要看的四个字段

nginx 上加这几行,放在 server 或 location 块里都行,前者覆盖面更大:

add_header Access-Control-Allow-Origin $http_origin always;
add_header Access-Control-Allow-Credentials true always;
add_header Access-Control-Allow-Methods "GET, POST, OPTIONS" always;
add_header Access-Control-Allow-Headers "Content-Type, Authorization" always;
add_header Vary Origin always;

加完 reload,再发一次请求,Response Headers 里应该能看到这五行——四个 CORS 字段加一行 Vary。四个字段不是每次都全查:简单请求只看 Allow-Origin,Allow-Methods 和 Allow-Headers 只在预检那条 OPTIONS 里被检查,Allow-Credentials 只在带凭据时才生效。$http_origin 是把浏览器发来的 Origin 原样回显,不是写死的域名:写死一个,换个端口调试就又对不上了。

这里有两个照抄最容易踩的地方。一是 add_header 的继承:location 里只要自己写了任意一条 add_header,server 级这五行就全部失效,一条都不下发,要么挪进那个 location 重写一遍,要么全部放在 location 里。二是 $http_origin 在没有 Origin 的请求里是空串,回出来的 Allow-Origin 就是空的,用 map 兜一个默认值更稳。

OPTIONS 那条返回什么状态码,取决于谁答的:后端答就是后端的 2xx,nginx 里写了 if ($request_method = OPTIONS) { return 204; } 才是 204,真正的 POST 跟在后面。

Vary: Origin 这一行容易被省掉。省掉之后,CDN 或者浏览器缓存可能把带 A 域名的响应发给 B 域名,表现是刷新几次好了、过一会儿又坏,比一开始就报错更难查。

代理配置写在哪一层,决定改完要不要重启

Vite 的 dev server 里加一段转发,前端代码里的请求地址写成 /api/user:

server: {
  proxy: {
    '/api': {
      target: 'http://127.0.0.1:8080',
      changeOrigin: true,
      rewrite: (p) => p.replace(/^\/api/, ''),
    },
  },
},

改完这个文件要重启 dev server,热更新不会重载 proxy 这一段。换 target 指向的端口也一样,不重启就一直打到旧地址上,报的还是连接被拒绝。

生效之后 Network 里那条请求的地址变成 http://localhost:5173/api/user,Response Headers 里看不到任何 Access-Control- 开头的字段——浏览器认为这是同源请求,根本没进入跨域判断。

用代理这条路做前端解决跨域,等于把判断权从浏览器挪到构建工具上。代价是转发规则得跟着后端路由走:后端加一个前缀,代理这边就补一条,漏了表现出来是 404,不是 CORS 报错。这两种错误的排查方向完全不同。

credentials 打开之后,通配符全部作废

fetch 加上 credentials: 'include',或者 axios 设 withCredentials: true,服务端就不能再用星号。

左右两栏对照通配符与回显来源两种写法

浏览器在这一步的条件是固定的:Access-Control-Allow-Origin 必须是具体的 Origin,Access-Control-Allow-Credentials 必须是 true,两个同时满足才放行。

关于凭据的报错,浏览器那几条文案通常直接写明上面两条里哪一条不满足,照着补就行,不用逐行试。

边界:什么时候该停手

后端不在自己手里,响应头改不了,前端解决跨域就只剩代理一条路。反过来,能改响应头的时候硬上代理,等于多维护一份转发规则,还多一个会失效的环节。

同源策略比的是协议、域名、端口三样。http://localhost:8080 和 http://localhost:5173 算两个源,本地调试时这个组合撞上的次数最多。

内网系统只服务一个固定域名、端口也不再变的时候,把 Origin 写死是可以的。

浏览器插件关掉 CORS 只在开发机上有效,装到别人机器上就没了。

生产环境没有 dev server,同样的转发要在 nginx 或者网关上再写一遍,这块没有捷径。

这笔账算下来是:前端解决跨域的顺序不能反,能改响应头就改响应头,改不了才加代理;顺序倒过来,多花的时间不在改配置上,全在反复怀疑自己写错上。

若非作者标注皆为李涛自留地原创文章,转载或复制请以超链接形式并注明出处。