TapCub 正式上线:统计、分析、客服一个平台免费用
数据分析

Cache-Control 响应头怎么设:按文件类型给出取值

Cache-Control 决定浏览器和 CDN 把一个文件复用多久。哪些指令真正有用,每类文件该设什么值,以及一个算例:每次回访少 16 个请求。

林舟 发布于 2026 年 11 月 20 日 10 分钟阅读 数据分析
示例数据:一个 17 个请求、1,020 KB 的页面。距上次访问 5 天时,72 小时的启发式有效期已过,前两种配置多出 16 个条件请求,推荐配置只有 1 个请求。示例数据

Cache-Control 响应头告诉浏览器和 CDN:能不能留一份副本、副本多久内算新鲜、过期后怎么办。HTML 用 no-cache,文件名带哈希的静态文件用 max-age=31536000, immutable,个人页面用 private 或 no-store,别把这个选择交给缓存去猜。

读完你会知道

  • 新鲜的副本直接复用、不发请求,过期的要重新验证。没有 Cache-Control 时缓存会猜(RFC 9111 建议取距 Last-Modified 时间的 10%)
  • 取值要和地址匹配:带哈希的文件用 max-age=31536000, immutable,HTML 用 no-cache,个人页面用 private 或 no-store
  • no-cache 不等于不存储。示例里所有文件都用 no-cache 时每次访问 17 个请求,推荐配置只要 1 个,少了 94%

Cache-Control 响应头决定什么

服务器返回的每个响应都可以带一个 Cache-Control 头。它告诉浏览器和 CDN 这类共享缓存三件事:能不能留一份副本,这份副本在多长时间内算新鲜,过期之后该怎么办。副本还新鲜时直接复用,完全不发网络请求;过期了,要么向服务器做一次条件请求(通常返回很短的 304 Not Modified),要么直接丢掉。

如果完全不发 Cache-Control,缓存可以自己猜。RFC 9111(2022 年 6 月,4.2.2 节)写明:缓存看到 Last-Modified 日期时,可以按「距该日期过去的时间」的一个比例设定启发式有效期,并给出 10% 作为典型比例。MDN 对这种情况的建议很直接:只要你对缓存有要求,就在响应头里明确写出来。这个头的全部作用就是:对每一类文件用一个明确的决定代替猜测。

真正用得到的几个指令

指令有十几个,八个就能覆盖绝大多数网站。下面的定义依据 MDN 的 Cache-Control 参考页。

指令含义典型用途
max-age=N响应在生成后的 N 秒内保持新鲜任何可以不再询问就直接提供的文件
s-maxage=N同上,但只对 CDN 这类共享缓存生效;在共享缓存里覆盖 max-age,私有缓存会忽略它让 CDN 比浏览器多留一会儿页面
no-cache响应可以被存储,但每次复用前必须向源站验证HTML 和其他地址不变、内容会变的文件
no-store任何缓存(私有或共享)都不应存储这个响应账户页、收据、任何敏感内容
must-revalidate一旦过期,复用前必须验证过期副本会出错时,和 max-age 配合
immutable响应在新鲜期内不会变化地址里带版本号或内容哈希的文件
public / private共享缓存可以存储 / 只有浏览器自己的缓存可以存储与单个用户相关的内容用 private
stale-while-revalidate=N过期后的 N 秒内可以继续使用旧副本,同时在后台取新的稍微旧一点也无所谓的内容

有两个细节能省下很多排查时间。其一,max-age 从响应生成时开始算,不是从浏览器收到时开始,所以在 CDN 里待了 40 秒的响应只剩下少了 40 秒的有效期,Age 头报告的就是这段时间。其二,MDN 的参考页没有给 max-age 定义上限,但 web.dev 的 HTTP 缓存指南称 31,536,000 秒(一年)是支持的最大值,所以用这个值就够了。

按文件类型该设什么

取值取决于一个问题:这个地址的内容会不会变?如果地址本身带版本,内容可以缓存一年;如果地址不变而内容会变,浏览器就必须去问。下表是起点,属于经验判断而不是标准,发布流程不同的地方请自己调整。

文件类型地址会随内容变化吗建议的 Cache-Control原因
HTML 页面不会(/pricing 永远是 /pricing)no-cache,并带 ETag每次都检查,新版本立刻生效;一次 304 只有几百字节
带内容哈希的 CSS 和 JS(app.3f9a1c.js)会public, max-age=31536000, immutable新构建产生新地址,旧地址不需要过期
字体(带哈希或版本)会public, max-age=31536000, immutable字体几乎不变,而且下载代价高
文件名带哈希的图片会public, max-age=31536000, immutable理由和脚本相同
地址里没有版本的图片、CSS 或 JS不会max-age=86400(一天)或 no-cache较短的有效期限制了过期副本能存活多久
所有用户共用的接口响应不会public, max-age=60 或 s-maxage=60, stale-while-revalidate=30重复请求便宜,旧一分钟没问题
单个登录用户的接口响应或页面不会private, no-cache(敏感内容用 no-store)不让某个人的数据进入共享缓存
支付、账户或健康类页面不会no-store不应写入任何缓存

web.dev 的指南给出的也是两个极端:带指纹或版本的地址用 max-age=31536000,需要每次使用前重新验证的资源用 no-cache,并用 ETag 让验证变得便宜。表中其余各行都介于这两端之间。

文件类型建议的 Cache-Control原因
HTML 页面no-cache,并带 ETag每次都检查,新版本立刻生效
带哈希的 CSS、JS、字体、图片public, max-age=31536000, immutable新构建产生新地址,旧地址不需要过期
地址里没有版本的图片、CSS、JSmax-age=86400,或 no-cache较短的有效期限制过期副本的存活时间
所有用户共用的接口响应public, max-age=60重复请求便宜,旧一分钟没问题
单个用户的页面或接口private, no-cache不让个人数据进入共享缓存
支付、账户、健康类页面no-store不写入任何缓存

依据 MDN 和 web.dev 的指导给出的起点,不是标准。请按你自己的发布流程调整。

算例:回访一次要付出什么

示例数据:一个页面由 1 个 HTML 文档(30 KB)、1 个样式表(80 KB)、1 个脚本(250 KB)、2 个字体(共 60 KB)和 12 张图片(600 KB)组成,首次访问是 17 个请求、1,020 KB。假设一次 304 响应的头部约 0.4 KB,HTML 自上次访问后已经更新,静态文件的最后修改时间是 30 天前。比较三种配置下的回访:

  • A. 没有 Cache-Control。 启发式有效期是 30 天的 10%,即 72 小时。
  • B. 全部文件都是 no-cache。 每次访问都重新检查每个文件。
  • C. 带哈希的静态文件用 max-age=31536000, immutable;HTML 用 no-cache。
回访时间A:没有响应头B:全部 no-cacheC:推荐配置
1 天后1 个请求,30 KB17 个请求,36.4 KB1 个请求,30 KB
5 天后17 个请求,36.4 KB17 个请求,36.4 KB1 个请求,30 KB
8 天后17 个请求,36.4 KB17 个请求,36.4 KB1 个请求,30 KB

计算过程:配置 B 要发 1 次完整 HTML(30 KB)加 16 次条件请求(16 × 0.4 KB = 6.4 KB),共 17 个请求、36.4 KB。配置 A 在前 72 小时的表现和 C 一样,到第 5 天因为猜测的有效期已过而一下子退化;如果文件是两天前修改的,这个猜测只能维持 4.8 小时。配置 C 每次回访只需 1 个请求,相对 B 以及第 3 天之后的 A 少了 16 个请求(94%)。字节数看起来差得不多,是因为 304 本身很小;B 的真正代价是多出的 16 次往返,每一次都可能让慢网络卡住渲染。首次访问在三种配置下都是 1,020 KB,所以缓存对第一次加载没有帮助,它帮的是之后的每一次。

app.tapcub.com

回访时的请求数(5 天后)

示例页面,17 个请求
没有 Cache-Control(猜测已过期)17
所有文件 no-cache17
哈希文件 immutable,HTML no-cache1
示例数据
示例数据:一个 17 个请求、1,020 KB 的页面。距上次访问 5 天时,72 小时的启发式有效期已过,前两种配置多出 16 个条件请求,推荐配置只有 1 个请求。

为什么 no-cache 不等于「不缓存」

最常见的错误是把 no-cache 读成「不要存」。MDN 说得很清楚:no-cache 不是「不缓存」。响应可以被存储,但每次复用前必须向源站验证。RFC 9111(5.2.2.4 节)描述的行为一致:已存储的响应在没有先转发请求做验证的情况下不能使用。真正禁止存储的指令是 no-store(5.2.2.5 节)。

这在两个方向上都有影响。给带哈希的 JavaScript 文件加 no-cache,你每次访问都要付 16 次验证往返,就像上面的配置 B。给含个人数据的页面加 no-cache 并以为它不会被存下来,则是依赖了一个允许存储的指令。这类页面请用 no-store,前面有 CDN 时再加上 private。

长有效期只有在地址会变时才安全

表里一年的 max-age 有个前提:每次发布必须产生新地址。构建工具的做法是在文件名里放内容哈希,代码一变,app.3f9a1c.js 就成了 app.b72e04.js。每次都会重新验证的 HTML 指向新文件名,旧文件自然不再被请求。

做不到这一点,长有效期就是陷阱。给 /styles.css 设 max-age=31536000,意味着回访用户可以保留旧样式表长达一年,而你无法召回。先把地址固定下来,再拉长有效期。

immutable 还有一个好处。RFC 8246(2017 年 9 月)解释说,普通刷新时浏览器会对子资源发条件请求,即使网站是靠更换地址来更新的,这些请求也只会返回 304。带上 immutable,客户端在响应新鲜期内应当跳过它们,只有用户明确的强制刷新才会覆盖。

共享缓存和个人数据

CDN 是共享缓存,所以会遵守 s-maxage、public 和 private。三条规则能避开大部分麻烦。

  1. 与单个用户相关的内容用 private。 标了 private 的响应只能存在浏览器自己的缓存里。
  2. 用 s-maxage 给 CDN 一个与浏览器不同的有效期。 对每小时更新一次的博客列表页,max-age=0, s-maxage=3600 让 CDN 扛住流量,而浏览器每次都重新检查。
  3. 稍旧一点也能接受时用 stale-while-revalidate。 MDN 的例子是 max-age=604800, stale-while-revalidate=86400:7 天内新鲜,之后再多一天可以复用旧副本,同时在后台取新的。

还要留意那些悄悄关掉缓存的响应头。Cloudflare 的默认缓存行为页面把 private、no-store、no-cache、max-age=0 和 Set-Cookie 头列为响应不会在其边缘节点缓存的原因。其他 CDN 有各自的规则,所以请用下一节的命令测试你的环境。

怎样查看服务器实际发了什么

除了浏览器,不需要别的工具。

  1. 命令行。 运行 curl -sI https://example.com/assets/app.3f9a1c.js,读 cache-control 那一行;HTML 页面也做一遍。再加上 -H "If-None-Match: <etag>" 重复一次,确认重新验证返回 304。
  2. 浏览器开发者工具。 打开 Network 面板,刷新两次,看 Size 列。显示 (memory cache) 或 (disk cache) 表示没有发请求;几百字节且状态为 304 表示发生了一次重新验证。
  3. 找出缺失的响应头。 没有 Cache-Control 的文件都靠猜测在缓存。按文件类型列出来,给上表里的每一行指定一条规则。
  4. 发布后检查响应。 确认 HTML 指向新文件名,并且旧的带哈希文件仍能提供给持有缓存页面的访客。

怎样在 TapCub 里看到效果

接着上面的例子。你上线配置 C 之后,需要的是真实访客加载更快的证据,而不只是响应头看起来对了。TapCub 不设置也不读取你的响应头,它衡量的是访客的实际体验。

TapCub 性能报表:LCP、CLS、INP、FCP、TTFB 五张真实用户指标卡,加载拆分和 P75 LCP 趋势
演示数据:第 2 步读取的性能报表,含 P75 指标卡和趋势线。数字是演示值,不是客户数据。
  1. 标出变更。 在 配置 › 日期标注 里为发布日期加一条标注,图表上就会显示这个日期。
  2. 打开真实用户数据。 在 监测 › 性能 里看最大内容绘制和首字节时间两张卡片。TapCub 把 LCP 在 2.5 秒以内评为良好、超过 4 秒为差,把 TTFB 在 800 毫秒以内评为良好、超过 1.8 秒为差。把卡片切到 P75,因为缓存帮助的正是较慢的那批访客。
  3. 对比相同长度的时间段。 性能页面没有上一周期对比,所以先把日期范围设为变更前两周,记下 P75 的数值,再对变更后两周重复一次。
  4. 找出没有改善的页面。 最慢页面 列表按 P75 的 LCP 排序;一直留在列表里的页面,多半是没缓存的 HTML 或没设长有效期的图片。

这些数字来自访客的浏览器,所以包含回访用户,也就是缓存影响最大的那批人。TapCub 负责报告结果,响应头本身要在你的网络服务器或 CDN 里设置。

常见问题

静态文件的 Cache-Control 该设成什么?

文件名里带版本或内容哈希的文件,用 public, max-age=31536000, immutable。一年是 web.dev 列出的最大值,immutable 能让浏览器刷新时不再重新检查。文件名固定的静态文件,用较短的有效期,例如 max-age=86400,或者 no-cache 加 ETag。

no-cache 和 no-store 有什么区别?

no-cache 允许缓存存储响应,但每次复用前要向源站验证。no-store 告诉所有缓存(私有或共享)完全不要存储响应。经常变化的 HTML 用 no-cache,绝不能写入磁盘的页面,比如账户或支付页,用 no-store。

max-age=0 起什么作用?

它让响应立即过期,所以缓存复用前必须先向源站确认。副本过期会出错时,把它和 must-revalidate 配合。有些 CDN 对这种响应根本不缓存:Cloudflare 的文档把 max-age=0 列在默认会停止边缘缓存的取值里。依赖它之前,先确认你的 CDN 怎么处理。

Cache-Control 是服务器设置还是浏览器设置?

由服务器写在响应里,浏览器照着执行。浏览器自己也会在请求里发 Cache-Control,比如刷新时的 max-age=0,但决定副本保持多久新鲜的是响应头。请在网络服务器、应用框架或 CDN 里配置。

还需要 Expires 或 Last-Modified 吗?

有 Cache-Control: max-age 时不需要 Expires,因为 max-age 优先。ETag 或 Last-Modified 要保留:它们让服务器可以回答 304 Not Modified 而不用重新发送文件,使重新验证变得便宜。

资料来源

归档:数据分析

这篇文章对你有帮助吗?

我们会根据反馈修改和补充这篇内容。

林舟

产品体验专员

关注产品体验、功能使用与增长实践,喜欢把复杂流程拆成清晰步骤,让分析结果更容易用到日常决策中。

确认更快的缓存真的惠及真实访客

按页面和设备查看真实用户的 LCP 和首字节时间,图表上标出发布日期。

看清数据,找到增长。

每一次点击,都有数据依据。装好一行代码,1 分钟看到第一批数据。

无需信用卡 · 统计与客服都有免费版 · 统计无 Cookie