你在本地起了两个服务:8000 端口放页面,8001 端口放接口,都用 python -m http.server 跑着。页面里一行 fetch 请求接口,网络面板里状态 200,控制台却一片红字,说响应没有 Access-Control-Allow-Origin,浏览器不让读。

换个场景:登录接口通了,响应里明明有 Set-Cookie,下一次请求的请求头里却干干净净,一个 Cookie 都没有,接口把你看成未登录。代码里写了 credentials: "include",还是不带。

这两件事看着是两处 bug,其实问的是同一个问题:浏览器什么时候肯把跨源响应交给脚本,什么时候肯把 Cookie 附到请求上。答案不在业务代码里。

先把现场还原:谁拒绝了谁

本地起两个端口,就是为了制造跨源。8000 的页面请求 8001,浏览器拿到 200,读完响应头,发现服务器没声明允许这个来源读,于是把内容扣下,只留一句错误给脚本。注意,请求真的发出去了,服务器也可能已经写库、发信。

所以第一个要改的观念是:CORS 报错不等于请求没发生,只等于脚本读不到结果。要确认请求到没到服务器,看服务端日志,别只看控制台。本机用 Python 3.15 起 8000/8001,headless Edge 156 打开 8000 的页面,fetch 被拒,DOM 里写的是 CORS_BLOCKED:Failed to fetch;8001 的日志同时打出 GET /data.json 200。curl 加不加 Origin 都没有 Access-Control-Allow-Origin,因为 python -m http.server 根本不发这个头。

Cookie 也同理。存不存、发不发,是浏览器按属性做的决定。写 credentials 只是允许浏览器考虑带上凭证,带不带还得看 Cookie 自己满足不满足条件。

请求头里的 Cookie 由浏览器自动添加,响应头里的 Set-Cookie 由浏览器自动消费。前端代码只能用 document.cookie 读写一部分 Cookie,永远无法直接设置 Cookie 这个请求头。

一次请求里,到底有哪几层

把一次跨源请求按原始报文看一遍,比看示意图都清楚。请求是这样的:

GET /api/profile HTTP/1.1
Host: 127.0.0.1:8001
Origin: http://127.0.0.1:8000
Cookie: PHPSESSID=abc123
Accept: application/json

第一行是请求行:方法、路径、协议版本。下面每行是「头」,格式为名字加冒号加值。Host 说明访问哪个主机和端口;Origin 由浏览器在跨源请求里自动加,报告请求从哪来;Cookie 是浏览器从本地存储里挑出来的、满足条件的那几对键值。空行之后是请求体,GET 一般没有。

响应长这样:

HTTP/1.1 200 OK
Content-Type: application/json
Access-Control-Allow-Origin: http://127.0.0.1:8000
Access-Control-Allow-Credentials: true
Set-Cookie: PHPSESSID=abc123; Path=/; HttpOnly; SameSite=Lax

{"name":"alice"}

状态行之后是响应头,再之后是响应体。Origin 由浏览器写,脚本改不了,服务端可以把它当「浏览器报告的来源」,但不能当身份。Set-Cookie 是写给浏览器的指令,脚本读不到;Access-Control-Allow-Origin 也是写给浏览器的,脚本只能通过成功与否间接感知。

「谁写、谁读」搞清楚了,后面就好解释:CORS 和 Cookie 属性都是服务器对浏览器说的话,不是说给用户或脚本听的。说错对象,配置就会看着生效、实际不生效。

Cookie 的六个属性,每一个都会让请求带不上

Cookie 不是登录成功就有。下发时那串分号属性,决定它存在哪、发给谁、何时过期、脚本能不能读。

属性管什么写错时的典型现象
Domain这个 Cookie 允许发给哪些主机写成别的域,当前站点带不上;范围过大,所有子域共享一份会话
Path只有路径前缀匹配的请求才带上登录接口在 /auth 下发的 Cookie,随后访问 /api 带不上
Expires 与 Max-Age持久化还是会话级,何时失效没写就关浏览器即失效;写太长又扩大了被窃取后的可用窗口
HttpOnly禁止页面脚本通过 document.cookie 读取没写,一旦有 XSS,会话标识能被直接读走
Secure只在 HTTPS 请求里发送在 http 页面下调试,Cookie 静悄悄地不发,控制台一切正常
SameSite跨站请求时带不带这个 CookieStrict 导致从外部链接进来显示未登录;None 没配 Secure 直接被拒收

Domain 和 Path 决定范围,Expires 决定寿命,HttpOnly 和 Secure 决定谁能拿到、走什么通道,SameSite 决定什么场景允许带上。难的不是名字,是它们只在特定组合里起作用,平时看不出来。

SameSite 值得多说一句。Strict 只允许同站请求;Lax 允许顶层 GET 导航,跨站 POST 和子资源请求不带;None 允许跨站,但必须同时标 Secure,否则现代浏览器拒收。主流浏览器这几年把未显式声明的默认值收紧到了 Lax,老项目升级后跨站登录态可能突然失效,不是浏览器坏了,是默认值变了。

同源到底怎么算

「源」由协议、主机、端口三样组成,三个全一样才算同源。判断是字符串比较,不是「看起来像」。下面这些全部不同源:

http://127.0.0.1:8000   与  http://127.0.0.1:8001     端口不同
http://example.com      与  https://example.com      协议不同
https://a.example.com   与  https://b.example.com    主机不同
http://localhost        与  http://127.0.0.1          主机字符串不同

最后一条常有人踩:localhost 和 127.0.0.1 在浏览器眼里是两个主机名。端口没写时按默认补,http 是 80,https 是 443。

还有个容易混的概念:同站不等于同源。同站看可注册域名,a.example.com 和 b.example.com 算同一个站;同源要求三样全等。SameSite 按同站判断,CORS 按同源判断,结论可能相反。

同源策略最核心的一条:一个源的脚本不能读另一个源的响应内容、DOM 和存储。注意是「读」,不是「发」。跨源请求照发,只是脚本拿不到内容。这个不对称,正是后面 CSRF 能成立的原因。

简单请求与预检:浏览器先问一句

不是所有跨源请求都直接放行。简单请求条件很窄:方法是 GET、HEAD、POST;头只能在少数安全名单里;有 Content-Type 时只能是表单那三种。符合就直接发,服务器补允许来源,浏览器再决定给不给脚本读。

不符合的,比如 PUT、DELETE,比如 application/json,比如自定义头,浏览器先发一个 OPTIONS,叫预检。它不带请求体,只问「我要用这个方法、带这些头,你允许吗」。服务器回一组允许项,浏览器核对通过才发真请求。

简单请求

直接发,一次往返。服务器只要在响应里回允许来源。它同样会带 Cookie,也同样会触发服务端副作用。

需要预检的请求

先 OPTIONS 再发真请求,两次往返。预检和真请求两个响应都要配好允许项,漏一处真请求就发不出去,面板里只剩一条 OPTIONS。

带凭证的跨源请求还有硬规则:允许凭证必须是 true,且允许来源不能是星号,必须回具体源。不少项目只加了星号,发现带不上 Cookie,就改成「把请求里的 Origin 原样回写」,这一步往往就是事故的开始。

预检请求永远不带 Cookie。网关如果在 OPTIONS 之前先做登录校验,预检会被 302 到登录页;而浏览器规定预检不允许跟随重定向,于是报错,真请求发不出去。这类问题在「本地好好的,一上网关就挂」的项目里很常见。

浏览器到底在保护谁

很多人以为同源策略是「防止坏人访问你的接口」。不是。它保护的是用户在浏览器里的数据:你打开的 A 站页面,不能让 A 站的脚本读到你在 B 站的邮箱、银行页面、内网系统。它假设每个源是独立的信任域。

所以它的边界很明确:管不住跨站请求的发送,管不住服务端自己发起的请求,也管不住同一个源里的 XSS,脚本本来就能读自己源的数据。

它也不是一条规范,而是浏览器厂商累积的一组规则,各处松紧还不一样。你能改的只有服务端配合的部分。

一次跨源带凭证请求要过的四道关
第一道:SameSite这次请求算不算跨站。算跨站,且 Cookie 标了 Lax 或 Strict,浏览器根本不带。
第二道:Secure 与 Path、Domain通道是不是 HTTPS,路径和域是否匹配。有一条不满足,Cookie 照样不发。
第三道:预检方法或头不在简单请求范围时,浏览器先问 OPTIONS,服务器答不上来就没有下一步。
第四道:CORS 响应头真请求回来了,浏览器核对允许来源与是否允许凭证,通过才把响应交给脚本。

前三道没过,现象是「请求发了但不对」或「根本没发」;只有第四道没过才是那句熟悉的红字。按这个顺序排查,比凭印象改配置快。

完整走查:登录明明成功,下一个请求却是未登录

角色:页面在 8000,接口在 8001,浏览器执行,服务端日志旁观。目标是登录后拿到会话,再请求个人信息。

第一步,页面发登录请求,Content-Type 是 application/json,需要预检。浏览器先发 OPTIONS,网关没单独处理,按普通请求走登录校验,没带 Cookie,被 302 到登录页。浏览器报预检不允许重定向,真请求没发。用 curl 复现一下:

curl -i -X OPTIONS "http://127.0.0.1:8001/api/login" \
  -H "Origin: http://127.0.0.1:8000" \
  -H "Access-Control-Request-Method: POST" \
  -H "Access-Control-Request-Headers: content-type"

看到 302 和 Location,问题就定位了:预检被当成了业务请求。修法是在网关放行 OPTIONS,或者让 CORS 中间件排在鉴权之前。

第二步,预检通过,登录成功,响应头来了 Set-Cookie。紧接着请求个人信息,Cookie 却不在请求头里。按四道关逐个查:SameSite 是 Lax,但两个端口同站,不拦;Path 是 /,匹配;都是 http,Secure 没设,不拦;Domain 没写,默认当前主机。看着都该带。

打开应用面板,发现同名 Cookie 有两条,一条域是 127.0.0.1:8001、Path 是 /api,另一条域是 127.0.0.1、Path 是 /。浏览器按域更精确、路径更长排序,先发的那条可能是旧会话,服务端读到过期值,判成未登录。清掉旧条目、统一 Domain 和 Path 后恢复正常。

第三步,如果页面和接口不同站,比如 app.example.com 和 api.other.com,Lax 会拦住跨站子请求。要么显式 None 加 Secure 并全站 HTTPS,要么改成同站部署或网关代理。

调试跨源时网络面板要勾「保留日志」,否则页面一跳,前面的 302 和预检就没了。curl 复现要手动带 Origin,否则走的配置分支可能和浏览器不同。

现象对照表

这张表把现象收在一起。遇到问题先按第三列动手,别先改业务代码。

现象真实原因第一步查什么
控制台报没有 Access-Control-Allow-Origin响应没带这个头,或带的值和请求来源不完全一致用 curl 带 Origin 复现,对比预检与真请求两个响应头
请求头里没有 Cookie,接口判未登录SameSite 跨站拦截、Secure 在 http 下不发送、Path 或 Domain 不匹配应用面板看该 Cookie 的四个作用域属性,再看请求算不算跨站
登录返回 302 后,后续请求丢了 Authorization 或 CORS 失败跨源重定向会剥掉部分请求头;预检不允许重定向;最终响应缺允许来源保留日志看整条重定向链,确认最后一跳的响应头
HTTPS 页面里的图片或脚本加载失败混合内容,浏览器阻止或升级不安全请求控制台搜 Mixed Content,把资源地址改成 https 或站点相对路径
浏览器升级后跨站嵌入的登录态失效SameSite 未声明,默认值收紧为 Lax看 Set-Cookie 是否显式写了 SameSite=None 且带 Secure
别的站点能读你的接口返回,还带着登录态允许来源被原样反射,同时允许携带凭证查网关或框架的 CORS 配置,是否按精确匹配而非前缀匹配

CORS 常见的三种配错

第一种,把请求里的 Origin 原样回写,同时允许携带凭证。看起来聪明,实际等于对所有来源开放。对方页面只要诱导用户发起请求,就能带着用户的 Cookie 读到数据。

// 错法:Origin 原样反射,再加允许凭证
res.setHeader("Access-Control-Allow-Origin", req.headers.origin);
res.setHeader("Access-Control-Allow-Credentials", "true");

第二种,白名单用前缀或包含判断。写 origin.startsWith("https://trusted.example.com"),看起来只放行一个域,实际 https://trusted.example.com.evil.test 也能通过;用 includes 更糟。正确做法是把来源解析成 URL,取出协议、主机、端口,和预先写死的完整源做等值比较。

第三种,把 Origin: null 也放进白名单。null 来源包括沙箱化的 iframe、某些本地文件场景、被重定向后的匿名上下文,它不代表安全的本地调试,反而谁都能触发。

// 相对稳妥:固定白名单,精确匹配,按需允许凭证
const allow = new Set(["https://app.example.com"]);
if (allow.has(req.headers.origin)) {
  res.setHeader("Access-Control-Allow-Origin", req.headers.origin);
  res.setHeader("Access-Control-Allow-Credentials", "true");
  res.setHeader("Vary", "Origin");
}

还有两个细节:响应要带 Vary: Origin,否则中间缓存可能把给 A 的响应发给 B;允许头不要全量反射,按接口实际用到的列出来,别把 Authorization 和自定义头一股脑放进去。

边界与代价

同源策略和 CORS 都不是访问控制。命令行工具、爬虫、移动 App、服务端之间的调用,都不受这套规则约束。CORS 只是浏览器自愿遵守的约定,防的是「别的站点的脚本借用户的浏览器读数据」,防不住直接连上来的客户端。所以鉴权、限流、参数校验,一个都不能因为「配了 CORS」而省掉。

放宽 CORS 的代价是实打实的。一旦允许某个来源带凭证访问,就等于把这个接口对这个来源的脚本完全开放。那个来源如果有 XSS,或者有一个被攻陷的子域,攻击者不用碰你的服务器,就能以用户身份读数据。不能因为前端联调方便就长期放星号。

SameSite 收紧的代价也很具体。OAuth 回跳、支付回跳、从邮件点进来的深链接,都可能因为 Lax 变成「进来是未登录」。这不是配错了,是安全模型和产品流程在设计上打架。合理做法是把这些流程显式设计成跨站带 Cookie,而不是把 SameSite 一路改成 None 了事。

调试也有代价。浏览器缓存、预检缓存、CDN 缓存、同名 Cookie 都会让「我明明改了」变成假象。可靠的做法是先用 curl 复现服务端行为,再回浏览器确认,两边对得上才叫定位。

CSP 在这里只给一句话定位:它是服务器告诉浏览器「这个页面只允许从哪些来源加载和执行资源」的白名单,方向是保护页面自身,和 CORS 的「允许谁读我」不是一回事。CSP 能降低 XSS 得手后的危害,但替代不了输出编码,后面讲 XSS 时会展开。

练习与小结

这一篇的重点收成四句:源是协议加主机加端口;Cookie 带不带由属性决定,不由前端代码决定;跨源请求分简单和预检,带凭证时允许来源不能是星号;同源策略限制读、不限制发,所以它不是访问控制。

当天可以做的练习都在本地,不需要外部授权:

  1. 建两个目录,各放一个 index.html,分别用 python -m http.server 8000 和 python -m http.server 8001 起服务,在 8000 的页面里 fetch 8001 的文件,看控制台的 CORS 报错,并确认服务端日志里请求确实到了。本机结果:headless Edge 得到 CORS_BLOCKED:Failed to fetch,8001 日志有 200。
  2. 用 curl -I http://127.0.0.1:8001/ 看响应头,再手动加 -H "Origin: http://127.0.0.1:8000" 看有没有变化,体会「浏览器加的头」和「服务器回的头」分别是什么。本机两种请求都没有 Access-Control-Allow-Origin。
  3. 本地起 DVWA,只监听 127.0.0.1,登录后打开应用面板,把 Set-Cookie 里每个属性抄下来,逐条判断它影响什么。本机登录响应实测:Set-Cookie: PHPSESSID=...; expires=...; Max-Age=86400; path=/; domain=127.0.0.1,没有 HttpOnly、Secure、SameSite。
  4. 给自己项目画一张源清单:页面在哪个源、接口在哪个源、哪些请求跨源、哪些带凭证,再回头看你现在的 CORS 配置。
以上练习只在自己机器上的本地服务里做。对任何非授权站点发起跨源探测、扫描或「顺手测一下」,都不属于学习范围。

这四项在本机都能复现,不需要公网域名或真实证书,也不必改动任何线上配置。

下一篇讲注入类问题:SQL 与命令拼接为什么会出事。这一篇讲数据在浏览器和服务器之间怎么流动,下一篇看它进入服务器后,被拼进 SQL 或 shell 时如何从「值」变成「语法」。