HTTP 缓存实战:强缓存、协商缓存与 CDN 串味的排查手册

举报
yd_257742204 发表于 2026/11/15 06:03:57 2026/11/15
【摘要】 从强缓存与协商缓存的区别讲起,梳理 index.html 被长缓存、只靠 Last-Modified 校验、CDN 与源站策略打架三个高频坑,并给出 Vary 串味、Nginx 可抄配置与三步验证方法。

一、先分清强缓存和协商缓存

浏览器取一个资源时只有三条路:命中强缓存直接用、协商缓存问一次服务器、完全重新下载。很多人配错,是把这三个状态混成一个"缓存开或关"。

强缓存由 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' 仍然可以强制绕过。两边是独立的,排障时要分开看。

五、验证方法

改完不要靠感觉。三步验证:

  1. curl -I https://example.com/index.html 看响应头里 Cache-Control、ETag 是否真的下发,注意反向代理可能覆盖。
  2. 第二次请求带上 -H 'If-None-Match: <上一步的ETag>',确认返回 304 且 body 为空。
  3. 浏览器 DevTools 的 Network 面板勾掉 “Disable cache”,刷新两次,看 Size 列显示 (disk cache) 还是实际字节数。

六、三条自检

  • 入口 HTML 是否是 no-cache,静态资源是否是长 max-age + hash?
  • 每个按请求头变化内容的接口,Vary 是否覆盖了全部变化维度?
  • 出现"改了没生效"时,第一反应是查 CDN 的 Age 与 X-Cache,而不是怀疑代码没发布。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。