两个几乎每个项目都会撞上的问题。一个是上线之后,用户反馈「还是旧页面」,你让他刷新也没用,得手动清缓存才行。另一个是本地开发一切正常,一接真实接口就红着一片 CORS policy,控制台里那句「已被 CORS 策略阻止」看着像后端坏了,但后端同学说他那边测是通的。

这两个问题一个出在缓存策略,一个出在同源策略,都属于「浏览器按规则办事,你没按它的规则来」。这篇把它们讲清楚:缓存什么时候直接用本地的、什么时候去问服务器;同源到底指什么、CORS 在拦什么、哪些错误是前端改不了的。读完你能判断一个「请求失败」到底该找谁。

先理解浏览器在请求前后做了什么

发一个请求之前,浏览器会先看本地有没有可用的缓存副本;拿到响应之后,它会看响应头决定这份内容能不能存、能存多久;如果请求跨了源,它还会检查对方有没有给「允许读取」的许可。这三件事都可能让请求「看起来发出去了,但你拿不到结果」。

一次请求要过的几道关
查本地缓存
发请求或复用缓存
同源/CORS 检查
把响应交给页面

注意最后一步的措辞是「交给页面」。跨域请求很多时候真的发出去了,服务器也真的回了,只是浏览器不把响应内容给你的 JS 看。这一点很关键,后面讲 CORS 时会再提。

缓存:强缓存和协商缓存

HTTP 缓存分两层,用大白话说:一层是「这段时间内别来问我,直接用你手上的」,另一层是「你来问一下我有没有变,没变就继续用旧的」。

强缓存

由 Cache-Control 里的 max-age 控制。在有效期内,浏览器直接用本地副本,连请求都不发,状态栏里可能显示「from disk cache」。

协商缓存

浏览器带着上次的标识去问服务器「变了吗」。没变就回 304,只回头部不带正文;变了就回 200 和新内容。

几个常见指令,混在一起很容易记错:

指令含义典型用途
max-age=31536000一年内直接用本地副本文件名带内容哈希的 JS、CSS、图片
no-cache可以存,但每次用之前必须问服务器HTML 入口页,保证拿到最新结构
no-store完全不许存含敏感信息的接口响应
immutable有效期内连刷新都不重新验证确定永不变化的静态资源

no-cache 名字有误导性,它不是「不缓存」,而是「缓存但每次要验证」。真正不缓存的是 no-store。这一点很多人第一次配缓存时都会搞反。

协商缓存靠两组头:服务器给 ETag,浏览器下次带 If-None-Match;或者服务器给 Last-Modified,浏览器带 If-Modified-Since。服务器比对之后决定回 304 还是 200。ETag 更精确,能识别「内容没变但修改时间变了」的情况。

缓存配错,事故长什么样

最常见的一种:给 HTML 也配了很长的 max-age。结果你上线了新版本,用户本地还拿着一份旧 HTML,里面引用的是旧的 JS 文件名,页面自然还是老样子。更麻烦的是,用户就算按 F5 也可能继续用缓存,只有强制刷新才管用,而他不会。

比较稳的组合是:HTML 用 no-cache 或很短的 max-age,每次进来先问服务器;JS、CSS、图片这些静态资源用「文件名带内容哈希 + 一年强缓存 + immutable」。内容一变,文件名就变,浏览器自然会去取新的,旧文件继续留在缓存里也不影响。

接口缓存是另一个坑。有些代理或 CDN 会把 GET 接口的响应缓存住,你改了数据,前端拿到的还是旧的。接口响应一般要显式设置 Cache-Control: no-store,或者在请求里加时间戳、版本号来打破缓存。这个决定通常得后端和运维一起做,前端单方面改不了。

「我本地刷新是新代码,用户那里是旧的」大概率不是代码没发上去,而是缓存策略的问题。先看响应头,再怀疑发布流程。

同源策略:浏览器在防什么

「源」由三样东西决定:协议、主机名、端口。三者完全一致才算同源。https://docs.czgrzx.cn 和 http://docs.czgrzx.cn 不同源(协议不同),https://docs.czgrzx.cn:8443 和默认的 443 也不同源(端口不同),docs.czgrzx.cn 和 api.czgrzx.cn 不同源(主机名不同)。

同源策略要防的事情很具体:你在 bank.com 登录了,浏览器里存着它的 Cookie。如果没有这条规则,你打开一个恶意网站,它就能在后台向 bank.com 发请求,浏览器自动带上你的 Cookie,再把响应内容读走。同源策略的作用就是:别的源的页面可以发请求,但读不到响应内容。

注意措辞:是「读不到」,不是「发不出」。<img>、<form> 这类方式本来就能把请求发到别的源,只是拿不到结果。正因为请求能发出去而 Cookie 会自动带上,才有了 CSRF 这类攻击。

CORS:服务器主动开一扇门

CORS(Cross-Origin Resource Sharing,跨源资源共享)不是浏览器单方面放宽限制,而是「服务器明确说:这个源可以读我的响应」。浏览器看到响应头里有许可,才把内容交给页面。

最简单的场景,服务器只要回一个头:

Access-Control-Allow-Origin: https://docs.czgrzx.cn

如果请求会带 Cookie、Authorization 这类凭证,事情就复杂一点:前端要写 credentials: 'include',服务器要回 Access-Control-Allow-Credentials: true,而且 Allow-Origin 不能是 *,必须是具体源。带凭证时还要求源精确匹配,这个规则经常被忽略。

const res = await fetch('https://api.example.com/user', {
  credentials: 'include',
});

还有一类请求会先「预检」。当请求用了 PUT、DELETE 这类方法,或者自定义了请求头(比如 X-Token),或者 Content-Type 不是那三种简单类型,浏览器会先发一个 OPTIONS 请求问服务器「我能不能这么干」。服务器要回允许的方法和头,浏览器才会发真正的请求。

// 预检请求里浏览器会带:
Access-Control-Request-Method: POST
Access-Control-Request-Headers: content-type,x-token

// 服务器要回:
Access-Control-Allow-Origin: https://docs.czgrzx.cn
Access-Control-Allow-Methods: POST, OPTIONS
Access-Control-Allow-Headers: Content-Type, X-Token
Access-Control-Max-Age: 86400

预检结果可以缓存一段时间(Max-Age),所以不是每次请求都多一次往返。但如果服务器根本没处理 OPTIONS,返回了 404 或 405,浏览器就会判定预检失败,真正的请求不会发出去。

常见报错与排查顺序

控制台里那句「已被 CORS 策略阻止」经常是结果,不是原因。按下面顺序看,能少绕很多路:

  • 先看网络面板:请求到底发出去了没有?状态码是多少?如果是 500,先修服务端错误,CORS 报错可能只是它的连带表现。
  • 响应头里有没有 Access-Control-Allow-Origin:没有就是后端没配;有但不等于当前源,看看是不是写成了 * 或者写错了域名/端口。
  • 带 cookie 却配了 *:这是明确不允许的组合,必须改成具体源并加 Allow-Credentials。
  • 有 OPTIONS 请求失败:看预检响应有没有允许对应的方法和头,很多时候是方法列了 GET 却忘了 POST。
  • 自定义头没被允许:加一个 X-Token 就会触发预检,服务器要显式列出来。
  • 看起来是 CORS,实际是混合内容:HTTPS 页面请求 HTTP 接口会被浏览器直接拦掉,这跟 CORS 无关,升级接口协议就行。

一个很现实的判断:CORS 是服务端授权问题,前端改代码基本解决不了。你能做的是加代理,让请求先打到同源的开发服务器,再由它转发。

开发时用代理

前端开发服务器把 /api 转发到后端,浏览器看到的始终是同源请求,没有跨域问题。代价是多一层配置,且只解决开发环境。

线上用同源反向代理

Nginx 把 /api 转发到后端服务,页面和接口同域,从根上避开 CORS,也不用处理 Cookie 的跨站属性。代价是前后端部署绑在一起,扩容和独立发布没那么灵活。

如果前后端确实要分开部署(比如前端在 CDN、后端在另一个域名),那就老老实实配 CORS,并把 Cookie 的 SameSite、Secure、Domain 一起考虑。只配一半,最后一定是「本地能跑、线上登录态丢失」。

走一遍真实排查:发布之后,一半用户还是旧页面

一次前端发版,十分钟后客服转来截图:按钮样式错位、点击没反应。开发自己打开线上地址,一切正常。这就是最典型的一类问题,因为「你看到的」和「用户看到的」根本不是同一份文件。

第一次判断:发布没成功。去看发布记录和服务器上的文件,时间戳是新的,用无痕窗口打开也是新页面。这一步排除「没发上去」。

第二次判断:缓存。在 Network 面板看首页 HTML 的响应头,发现它有 Cache-Control: max-age=604800,也就是七天强缓存。这意味着用户在七天内打开首页,浏览器根本不发请求,直接用本地那份旧 HTML。而旧 HTML 里引用的是一批旧文件名的 JS 和 CSS,那些文件也在缓存里。页面自然是旧的。

为什么你自己是新的。因为你开发时习惯开着 Disable cache,或者按过强制刷新。这个习惯恰好把问题藏起来了,所以「我这里是好的」几乎不能作为证据。

怎么改的。首页 HTML 改成每次都要向服务器确认(no-cache 或 max-age=0, must-revalidate),静态资源的文件名带上内容哈希,并给它们配一年长缓存。这样 HTML 永远是最新的,它引用的新文件名也一定能取到;老用户手里那份旧 HTML 引用的旧文件名还在缓存里,照样能用。

改完还有一小部分用户是旧的。再查发现中间有一层 CDN,它自己缓存了那份旧 HTML,源站改了头,CDN 还在按旧规则返回。处理方式是发布后主动刷新 CDN 上 HTML 这类文件的缓存,而不是等它自然过期。这类「链路上还有一层缓存」的情况,本地怎么测都测不出来。

同一批用户的第二个问题:登录态没了

旧页面的事刚处理完,另一个反馈上来:一部分用户打开页面后接口全返回 401,重新登录就好了。这类问题通常和跨域、Cookie 一起出现。

先看请求。接口在 api.example.com,页面在 www.example.com,不同源。请求头里确实没有 Cookie。代码里 fetch 没有写 credentials,默认是不带凭证的,所以服务端认不出人。

加上之后又报 CORS。改成 credentials: 'include',控制台立刻报跨域错误,原因写在响应头里:服务端配的是 Access-Control-Allow-Origin: *。带凭证的请求不允许用通配符,浏览器直接拒绝。这不是浏览器刁难,因为「允许任何源带着用户凭证读响应」本身就是危险的。

服务端改成回具体源。把请求头里的 Origin 原样回写,并加 Access-Control-Allow-Credentials: true,同时加 Vary: Origin,避免缓存把 A 源的响应给了 B 源。改完大部分用户正常了。

剩下的人卡在预检。有几个接口会带自定义头,属于复杂请求,浏览器先发 OPTIONS。服务端的网关没放行 OPTIONS,回了 405,预检失败,真正的请求根本没发出去。补上网关对 OPTIONS 的处理后恢复。

最后一批:SameSite。还有用户反馈「登录成功后下一页又退出」。看 Set-Cookie,Cookie 是 SameSite=Lax,而他们的页面是从另一个站点跳转过来的,跨站请求不带这个 Cookie。改成 SameSite=None; Secure 之后正常,前提是全站 HTTPS。

这串问题里,缓存和跨域看起来是两件事,但排查方式一样:先看请求有没有发出去、再看响应头给了什么许可,最后才回到业务代码。控制台的报错文案只是结果,别从结果开始猜。

现象对照:缓存与跨域的常见故障

你看到的现象更可能的原因第一步查什么
改完代码上线,用户还是旧样式,自己却是新的HTML 被强缓存,浏览器压根没发请求看首页响应的 Cache-Control;用无痕窗口对比
Network 里请求是 304,但页面内容还是旧的协商缓存返回「没变」,但本地那份确实是旧版本;也可能是中间代理缓存了旧响应看 ETag 是否随内容变化,再确认 CDN 是否命中旧缓存
请求状态 200,代码却拿不到数据,控制台报跨域响应里没有 Access-Control-Allow-Origin,或值与当前源不匹配在 Network 里看该请求的响应头,逐项对照 Origin
预检请求 OPTIONS 返回 404 或 405服务端或网关没有处理 OPTIONS,或没列允许的方法点开那条预检请求,看 Allow-Methods 里有没有实际用的方法
带凭证请求报跨域,响应头里是 *通配符与 Allow-Credentials 不能同时使用让服务端回具体源,并加 Vary: Origin
跨站跳转过来,登录态丢失Cookie 是 SameSite=Lax,跨站请求不携带看 Set-Cookie 里的 SameSite 与 Secure 属性

补充一个判断顺序:如果请求在 Network 里根本不存在,那不是跨域问题,是请求压根没发出去(代码报错、被拦截、页面已经卸载)。这时候盯着 CORS 看一天也不会有结果。

这套策略的边界与代价

  • no-cache 不是「不缓存」。它要求每次使用前向服务器确认,仍然可能返回 304 用本地副本;真正完全不存要用 no-store。这两个词搞混,会得出完全相反的结论。
  • 长缓存加哈希的代价在发布环节。新 HTML 引用的新文件,旧 HTML 仍引用旧文件,所以旧文件不能发版就删,否则灰度期间还没刷新缓存的用户会拿到 404,页面直接坏掉。常见做法是保留若干天再清理。
  • Vary: Origin 会让缓存命中率下降。同一份内容按源存了多个副本,CDN 的空间和回源次数都会增加。这是在「正确性」和「成本」之间必须付的一笔。
  • 预检结果缓存的代价是「改配置不立刻生效」。你调整了允许的头或方法,用户那边可能还在用缓存里的旧预检结果,要等 Max-Age 过期才恢复。
  • 同源反向代理省掉了 CORS,但把部署绑在了一起。前端和后端要一起上线、一起扩容,独立发布的灵活性没了。这是架构选择,不是纯粹的技术优劣。
  • CORS 不是访问控制。它只决定「浏览器允不允许页面读响应」,拦不住别人用脚本直接请求你的接口。接口该有的鉴权、限流、CSRF 防护一个都不能少;把 Allow-Origin 反射成任意来源,等于对所有人开门。

还有一个容易踩的边界:本地开发时用 localhost 访问,很多限制比线上宽松,配置也常常是临时的。所以「本地能带 Cookie」不能证明线上能带,必须拿真实域名和协议验证一遍。

当天就能做的四件事

  1. 用 curl -I 看一个静态资源的响应头,重点读 Cache-Control、ETag、Last-Modified;再把 ETag 的值放进 If-None-Match 再请求一次,看是不是 304。
  2. 在本地服务器上改一个文件的内容,但不清缓存刷新页面,观察状态码和页面内容,确认「304 不一定代表你看到的是新内容」。
  3. 用 curl 手动发一个带 Origin 头的 OPTIONS 请求,打印响应头,看你用的服务有没有回 Allow-Methods。
  4. 在本机开两个不同端口的页面,让 A 页面 fetch B 端口的接口,把控制台报错完整读一遍,再按上面表的顺序逐项对照。这比背定义快得多。

小结与下一篇

压缩一下:缓存分强缓存和协商缓存,max-age 决定要不要发请求,ETag 决定内容变没变;HTML 适合 no-cache,带哈希的静态资源适合长缓存;接口别被中间层缓存住。跨域方面,同源看协议、主机、端口,同源策略只拦住「读取响应」,CORS 是服务器给的许可,带凭证时不能用通配符,复杂请求还会先预检。

下一篇读页面为什么会卡。时机是刚好的:你已经知道「请求回来之前页面什么都做不了」,下一篇接着讲「请求回来之后,页面为什么还是慢」——长任务、渲染帧、内存增长这三类问题,正好接上这里的网络耗时。

想复习请求怎么写,回看常用浏览器 API;想弄清 Cookie 的属性和登录态怎么存,回看浏览器存储。缓存配错引发的「用户看到旧页面」,在用开发者工具排查问题里还有一套更完整的验证步骤。