你在本地起了两个服务: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 | 跨站请求时带不带这个 Cookie | Strict 导致从外部链接进来显示未登录;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 原样回写」,这一步往往就是事故的开始。
浏览器到底在保护谁
很多人以为同源策略是「防止坏人访问你的接口」。不是。它保护的是用户在浏览器里的数据:你打开的 A 站页面,不能让 A 站的脚本读到你在 B 站的邮箱、银行页面、内网系统。它假设每个源是独立的信任域。
所以它的边界很明确:管不住跨站请求的发送,管不住服务端自己发起的请求,也管不住同一个源里的 XSS,脚本本来就能读自己源的数据。
它也不是一条规范,而是浏览器厂商累积的一组规则,各处松紧还不一样。你能改的只有服务端配合的部分。
前三道没过,现象是「请求发了但不对」或「根本没发」;只有第四道没过才是那句熟悉的红字。按这个顺序排查,比凭印象改配置快。
完整走查:登录明明成功,下一个请求却是未登录
角色:页面在 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,要么改成同站部署或网关代理。
现象对照表
这张表把现象收在一起。遇到问题先按第三列动手,别先改业务代码。
| 现象 | 真实原因 | 第一步查什么 |
|---|---|---|
| 控制台报没有 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 复现服务端行为,再回浏览器确认,两边对得上才叫定位。
练习与小结
这一篇的重点收成四句:源是协议加主机加端口;Cookie 带不带由属性决定,不由前端代码决定;跨源请求分简单和预检,带凭证时允许来源不能是星号;同源策略限制读、不限制发,所以它不是访问控制。
当天可以做的练习都在本地,不需要外部授权:
- 建两个目录,各放一个 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。 - 用
curl -I http://127.0.0.1:8001/看响应头,再手动加-H "Origin: http://127.0.0.1:8000"看有没有变化,体会「浏览器加的头」和「服务器回的头」分别是什么。本机两种请求都没有Access-Control-Allow-Origin。 - 本地起 DVWA,只监听 127.0.0.1,登录后打开应用面板,把 Set-Cookie 里每个属性抄下来,逐条判断它影响什么。本机登录响应实测:
Set-Cookie: PHPSESSID=...; expires=...; Max-Age=86400; path=/; domain=127.0.0.1,没有 HttpOnly、Secure、SameSite。 - 给自己项目画一张源清单:页面在哪个源、接口在哪个源、哪些请求跨源、哪些带凭证,再回头看你现在的 CORS 配置。
这四项在本机都能复现,不需要公网域名或真实证书,也不必改动任何线上配置。
下一篇讲注入类问题:SQL 与命令拼接为什么会出事。这一篇讲数据在浏览器和服务器之间怎么流动,下一篇看它进入服务器后,被拼进 SQL 或 shell 时如何从「值」变成「语法」。