HTTP 缓存实战:强缓存、协商缓存与 CDN 串味的排查手册
一、先分清强缓存和协商缓存
浏览器取一个资源时只有三条路:命中强缓存直接用、协商缓存问一次服务器、完全重新下载。很多人配错,是把这三个状态混成一个"缓存开或关"。
强缓存由 Cache-Control: max-age=N 决定,在 N 秒内浏览器根本不发请求,DevTools 里显示 (from disk cache) 或 (from memory cache)。协商缓存由 ETag/If-None-Match 或 Last-Modified/If-Modified-Since 决定,浏览器会发请求,服务器返回 304 Not Modified 时只回响应头、不回 body。
一张表把关系钉住:
| 配置 | 浏览器行为 | 网络请求 | 典型用途 |
|---|---|---|---|
no-store |
完全不缓存 | 每次都发 | 支付页、含用户隐私的接口 |
no-cache |
缓存但每次校验 | 每次都发(可能 304) | HTML 入口 |
max-age=31536000, immutable |
强缓存一年 | 一年内不发 | 带 hash 的 js/css |
max-age=0, must-revalidate |
立刻过期,走过期校验 | 每次都发 | 需要快速生效的配置 |
二、最常见的三个坑
坑一:给 index.html 设了长 max-age。 入口 HTML 一旦被强缓存,用户就永远拿不到新的 <script src> 引用,发版后页面白屏或功能缺失。正确做法是 HTML 用 no-cache(可缓存但必须校验),静态资源用一年加 immutable,靠文件名 hash 换版本。这就是"内容哈希 + 入口不缓存"的组合。
坑二:只配了 Last-Modified 就以为有协商缓存。 Last-Modified 精度只到秒,同一秒内改两次文件服务器会说"没变"。而且它只判断时间,不判断内容:回滚到旧版本时 mtime 变新,反而会漏掉 304 机会。ETag 是内容指纹,精度更高,两者同时存在时浏览器优先用 ETag。Nginx 默认会为静态文件同时生成 ETag 和 Last-Modified,一般不用手写。
坑三:CDN 和源站缓存策略打架。 源站返回 no-store,CDN 那边配了边缘缓存 7 天,结果 CDN 缓存住了不该缓存的内容。排查时要在响应头里看 X-Cache、Age、Via 这类字段,确认到底哪一层给的缓存,而不是只看源站配置。
三、Vary 写错会让缓存串味
接口按 Accept-Encoding 或 Authorization 返回不同内容时,必须声明 Vary。少写一个维度,CDN 就会把 A 用户的响应给 B 用户。常见事故是移动端和 PC 端共用一个 URL,靠 User-Agent 区分,但 Vary 没带 User-Agent,于是 PC 用户拿到了移动端页面。
Vary: * 虽然安全,但等于告诉缓存层"这个响应不可复用",等于关掉缓存,不要拿它当兜底。
四、一份可以直接抄的配置
Nginx 里静态资源与 HTML 分开处理:
# 带 hash 的静态资源,缓存一年
location ~* \.(js|css|png|jpg|svg|woff2)$ {
add_header Cache-Control "public, max-age=31536000, immutable";
}
# 入口 HTML 必须每次校验
location = /index.html {
add_header Cache-Control "no-cache";
etag on;
}
# 接口默认不缓存
location /api/ {
add_header Cache-Control "no-store";
}
前端的 fetch 也有自己的缓存层,fetch(url, { cache: 'no-store' }) 只影响这一次请求,不会改变服务端响应头;反过来,服务端给了 immutable,前端加 cache: 'reload' 仍然可以强制绕过。两边是独立的,排障时要分开看。
五、验证方法
改完不要靠感觉。三步验证:
curl -I https://example.com/index.html看响应头里Cache-Control、ETag是否真的下发,注意反向代理可能覆盖。- 第二次请求带上
-H 'If-None-Match: <上一步的ETag>',确认返回304且 body 为空。 - 浏览器 DevTools 的 Network 面板勾掉 “Disable cache”,刷新两次,看 Size 列显示
(disk cache)还是实际字节数。
六、三条自检
- 入口 HTML 是否是
no-cache,静态资源是否是长max-age+ hash? - 每个按请求头变化内容的接口,
Vary是否覆盖了全部变化维度? - 出现"改了没生效"时,第一反应是查 CDN 的
Age与X-Cache,而不是怀疑代码没发布。
- 点赞
- 收藏
- 关注作者
评论(0)