Expires 头是一个 HTTP 响应头,带一个 GMT 日期,过了这个时间,缓存的响应副本就算过期。Cache-Control: max-age 用秒数表达同样的意思,两者同时存在时它优先,所以请设置 max-age,把 Expires 当作兜底。下文讲优先级顺序、各类文件的取值、在 nginx 和 Apache 里怎么设置,以及 curl 检查。
读完你会知道
- 缓存按 s-maxage、max-age、Expires 减 Date 的顺序计算新鲜期,都没有时才估算;无效的 Expires(如 0)表示已过期
- 带版本号的文件用 Cache-Control: public, max-age=31536000, immutable;HTML 和网址固定的文件用 no-cache 加 ETag
- 用 curl -sI 验证,再用 If-None-Match 把 ETag 发回去,应当返回 304
Expires 头是做什么的
Expires 响应头给出一个日期和时间,过了这个时刻,缓存里的响应副本就算过期。在此之前,浏览器或共享缓存可以直接复用已存储的响应,不必询问你的服务器。它的值是 GMT 的 HTTP 日期,例如 Expires: Thu, 31 Dec 2026 23:59:59 GMT。
有两点让它没有看上去那么好用。其一,它是固定的时钟时间,依赖服务器时钟和同一响应里的 Date 头;缓存把新鲜期算成 Expires 减 Date。其二,Cache-Control: max-age 用秒数表达同样的意思,两者同时存在时它优先。新项目请设置 Cache-Control,把 Expires 当作较老的兜底,因为一些工具和评分检查仍会找它。
缓存拿到过期的响应时,并不是「丢掉」。它会用校验器 ETag 或 Last-Modified 发一个条件请求,如果文件没有变化,服务器就返回没有正文的 304 Not Modified。所以合理的配置是:永不变化的文件用很长的新鲜期;会变化的文件用很短或为零的新鲜期,再配上校验器。
Expires 和 Cache-Control 谁说了算
RFC 9111 第 4.2.1 节规定了缓存计算响应新鲜期必须遵守的顺序:先看 s-maxage(只对共享缓存),再看 max-age,最后是 Expires 减 Date。只有这几项都没有时,缓存才可以自己估算;RFC 说典型的估算是距 Last-Modified 时间的 10%。第 5.3 节还规定,无效的 Expires 日期,尤其是值 0,必须当作过去的时间处理,也就是已经过期。
下面五种情况用后面的小脚本算出,全都使用 Date: Fri, 20 Nov 2026 12:00:00 GMT。
| 情形 | 出现的头 | 新鲜期 | 原因 |
|---|---|---|---|
| A | Cache-Control: public, max-age=31536000, immutable | 31,536,000 秒(一年) | 使用 max-age |
| B | 只有 Expires: Thu, 31 Dec 2026 23:59:59 GMT | 3,585,599 秒(41.5 天) | Expires 减 Date |
| C | max-age=3600,同时 Expires 在一年之后 | 3,600 秒(1 小时) | max-age 优先于 Expires |
| D | 只有 Last-Modified: Thu, 20 Aug 2026 12:00:00 GMT | 794,880 秒(9.2 天) | 启发式估算,取 92 天修改间隔的 10% |
| E | Expires: 0 | 0 秒 | 无效日期等于已过期 |
情形 D 要避免:没有明确新鲜期信息的响应,浏览器仍可能缓存它,缓存多久也不是你定的。情形 C 是常见的意外:服务器默认加了很远的 Expires,框架又加了很短的 max-age,短的那个悄悄生效。
不同类型的文件该设什么
覆盖大多数网站的规则:文件内容变化时文件名也变的,可以缓存一年;文件名不变的,必须重新校验。
| 文件类型 | 示例头 | 理由 |
|---|---|---|
| HTML 页面 | Cache-Control: no-cache 加 ETag(或 max-age=0, must-revalidate) | 指向其他文件的链接都在这里,必须始终是最新的;重新校验只花一次很小的 304 |
网址里带哈希或版本号的 JS 和 CSS(app.4f3a9c.js、site.css?v=a61c33dafb) | Cache-Control: public, max-age=31536000, immutable | 新构建会生成新网址,旧网址的内容永远不会变 |
网址固定的 JS 和 CSS(/js/app.js) | Cache-Control: no-cache 加 ETag,或较短的 max-age,如 3600 | 否则改动在整个新鲜期内到不了访客那里 |
| 永不变化的图片 | 已带版本号则 max-age=31536000, immutable;否则设一天到一个月 | 体积大,节省最多 |
| 网页字体 | max-age=31536000, immutable | 很少变化,所以一年是安全的 |
| 含个人数据的 API 响应 | Cache-Control: no-store | no-store 禁止任何存储,包括 CDN |
Google 的 web.dev 指南与此一致:带版本号的网址加 Cache-Control: max-age=31536000,这是规范支持的最大值;没有版本号的网址用 no-cache,让浏览器保存副本但每次都要重新校验,no-store 只留给绝不能被存储的响应。它还推荐把 ETag 作为更准确的校验器。Chrome 的 Lighthouse 审计「使用高效的缓存策略提供静态资源」会标出状态为 200、203 或 206、且没有明确 no-cache 策略的字体、图片、媒体、脚本和样式表,并建议在文件名里放哈希,让每个版本都不同。
| 文件类型 | 要发送的 Cache-Control | 新鲜期 |
|---|---|---|
| HTML 页面 | no-cache 加 ETag | 每次使用前校验 |
| 网址里带哈希或版本号的 JS 和 CSS | public, max-age=31536000, immutable | 1 年 |
| 网址固定的 JS 和 CSS | no-cache 加 ETag,或 max-age=3600 | 0 到 1 小时 |
| 带版本号的图片和字体 | public, max-age=31536000, immutable | 1 年 |
| 含个人数据的 API 响应 | no-store | 不存储 |
大多数网站的起点。先给文件名加版本号,再拉长新鲜期。
正确的缓存能省多少
示例数据:一个页面 520 KB:20 KB HTML、180 KB JavaScript、60 KB CSS、20 KB 字体和 240 KB 图片。访客一次会话浏览 5 个页面。每个页面有自己的 HTML 和图片;JavaScript、CSS 和字体是共用的。
- 完全没有缓存头,也没有启发式缓存: 5 × 520 KB = 2,600 KB。
- 带版本号的共用文件缓存一年: 第一个页面花 520 KB;之后四个页面只需要 HTML 和图片,各 20 + 240 = 260 KB。合计 520 + 4 × 260 = 1,560 KB。
- 节省: 1 − 1,560 ÷ 2,600 = 40%,而回访的节省更大,因为下一次会话也会复用那 260 KB 的共用文件。
效果大小取决于页面里共用部分的比例。多个页面共用大体积 JavaScript 包的网站收益最大;满页都是独特照片的页面收益最小。请测自己的比例,不要假设。
5 次页面浏览传输的数据量
示例数据,KB怎样设置这个头
nginx: expires 指令同时设置两个头。expires 24h; 生成「当前时间加 24 小时」的 Expires 和 Cache-Control: max-age=86400;负值得到 Cache-Control: no-cache;expires max; 把日期设在 2037 年、max-age 设为十年。因为通常还想要 immutable,请自己设置这个头。单用 expires 1y; 只有 max-age 没有 immutable,再叠加 add_header Cache-Control 会发出第二行 Cache-Control,所以只用 add_header:
# 对带版本号的静态文件设置一年的新鲜期,并标明内容不会变化
# 只用 add_header,避免和 expires 指令一起使用时出现两行 Cache-Control
location ~* \.(?:js|css|woff2)$ {
add_header Cache-Control "public, max-age=31536000, immutable";
}
Apache: 启用 mod_expires,然后用 ExpiresActive On 和 ExpiresByType,例如 ExpiresByType image/png "access plus 1 years"。这个模块会同时生成 Expires 和 Cache-Control: max-age。如果响应里已经有 Expires 或 Cache-Control 头,模块不会改动。要加 immutable,用 mod_headers 的 Header 指令。
CDN 和托管平台: 大多数允许把浏览器的新鲜期和 CDN 自己的新鲜期分开设置。需要不一致时,CDN 用 s-maxage,浏览器用 max-age。源站也要保留这个头,不要依赖某一个服务商的默认值。
怎样用 curl 检查响应头
只请求响应头,然后看三行:
# -s 不显示进度,-I 只请求响应头;grep 只留下和缓存有关的几行
curl -sI https://example.com/assets/app.4f3a9c.js | grep -iE "^(cache-control|expires|etag|last-modified|date|age)"
2026 年 11 月 20 日从 tapcub.com 取到的真实响应,展示了带版本号样式表(/assets/css/site.css?v=...)的样子:
# 带版本号的样式表:缓存一年,且声明内容不会变
cache-control: public, max-age=31536000, immutable
etag: "74901612811fa444ef18ec9e3626f698"
以及 HTML 首页:
# HTML 首页:每次使用前都要向服务器校验
cache-control: public, max-age=0, must-revalidate
然后把校验器发回去,测试重新校验:
# 把上一步拿到的 ETag 原样发回去,看服务器是否返回 304
curl -sI -H 'If-None-Match: "74901612811fa444ef18ec9e3626f698"' https://example.com/assets/app.4f3a9c.js
文件没变,应返回 304 Not Modified。返回 200 说明服务器忽略了 If-None-Match,每次过期后的访问都会重新下载整个文件。在浏览器里,开发者工具网络面板的「大小」列,命中新鲜缓存时显示「(disk cache)」或「(memory cache)」,304 则显示很小的传输量。
像上面的表那样,用一个头集合计算新鲜期:
# 用法示例:lifetime({'Cache-Control': 'max-age=3600'}) 返回 3600;情形 A 到 E 都可以这样验证
# 这个脚本只用标准库,不需要安装任何依赖,复制后可以直接运行
import re
from email.utils import parsedate_to_datetime as pd # 把 HTTP 日期解析成 datetime
def lifetime(h): # 输入:响应头字典,输出:新鲜期(秒)
h = {k.lower(): v for k, v in h.items()} # 头名不区分大小写,先统一成小写
m = re.search(r'max-age=(\d+)', h.get('cache-control', '')) # 先找 max-age
if m: return int(m.group(1)) # 有 max-age 就直接用,它优先于 Expires
if 'expires' in h: # 没有 max-age,再用 Expires 减 Date
try: return max(0, int((pd(h['expires']) - pd(h['date'])).total_seconds()))
except Exception: return 0 # 无效日期(例如值 0)无法解析:视为已过期,新鲜期为 0
if 'last-modified' in h: # 都没有时,按距修改时间的 10% 估算
return int(0.1 * (pd(h['date']) - pd(h['last-modified'])).total_seconds())
return 0 # 没有任何新鲜期信息,按 0 处理,每次都要校验
常见错误
- 网址永不变化的文件设了很远的新鲜期。 你修好了 CSS,访客一年内还在用旧的。办法:在网址里加哈希或版本号,或把这个文件改成
no-cache。 - HTML 上设了很长的
max-age。 页面一直指向旧的文件名。HTML 用no-cache或max-age=0, must-revalidate。 - 把
no-cache和no-store混为一谈。no-cache是「可以存,但用之前要先校验」;no-store是「不要存」。对静态文件用no-store,会把缓存的好处全部丢掉。 - 两个互相冲突的头。
max-age=3600加上一年后的Expires,实际只有一小时(上面的情形 C)。要查访客实际连到的服务器返回的最终响应,不要只看配置文件。 - 没有校验器。 既没有
ETag也没有Last-Modified的过期响应无法重新校验,每次过期都要完整下载。 - 在共享缓存上缓存带 Cookie 或个人数据的响应。 用
private或no-store。
在 TapCub 里看缓存有没有起作用
TapCub 不设置你的响应头,也不是 CDN;它衡量的是你改完之后真实访客的体验。
- 先记基线。 打开 监测 › 性能,这里是真实用户的 Core Web Vitals。用 最慢页面 列表,记下最慢页面的 P75 最大内容绘制,以及评为良好(2.5 秒以内)的占比。
- 标记改动。 在 配置 › 日期标注 里,给部署缓存头的那天加一条标注,图表上就能看到改动发生的时间。
- 读加载耗时。 报告把一次加载拆成后端(首字节时间)、网络传输和前端渲染。缓存静态文件主要缩短回访访客的网络传输;如果慢在首字节时间,响应头解决不了。
- 一周后对比。 回到同样的页面、同样的 P75。页面样本很少时百分位会跳动,所以要看流量足够的页面。如果数字没动,用 curl 确认响应头真的到了访客那里。
关于速度与排名的背景见如何优化网站性能,关于图片体积见为网页优化图片。
常见问题
Expires 头是什么?
它是一个带 GMT 日期和时间的 HTTP 响应头,过了这个时刻,缓存的响应就算过期。在此之前,浏览器或共享缓存可以不联系服务器直接复用。如果响应里同时有 Cache-Control: max-age,它优先,Expires 会被忽略。
该用 Expires 还是 Cache-Control?
新项目用 Cache-Control: max-age,因为它是相对的秒数,并且优先。只有较老的工具或审计仍要检查时才保留 Expires,并保证两者给出的新鲜期一致。不一致时以 max-age 为准,可能让你意外。
Expires 头该设什么值?
网址随内容变化的文件,新鲜期用一年:Cache-Control: max-age=31536000, immutable。HTML 和网址固定的文件,用 no-cache 加 ETag,让浏览器重新校验。Expires 设为过去的日期或值 0,会把响应标为已过期。
怎样在 nginx 或 Apache 里加 Expires 头?
nginx 在静态文件的 location 里用 expires 1y;,它会设置 Expires 和 Cache-Control: max-age。Apache 启用 mod_expires,设置 ExpiresActive On,再加 ExpiresByType 规则,如 "access plus 1 years"。要加 immutable,在 nginx 用 add_header,在 Apache 用 mod_headers 自己设置 Cache-Control。
怎样检查这个头有没有生效?
对文件网址运行 curl -sI,看 cache-control、expires 和 etag。再用 If-None-Match 把 ETag 发回去,应当返回 304 Not Modified。在浏览器开发者工具里,网络面板对来自缓存的文件显示「(disk cache)」。
资料来源
- IETF,RFC 9111:HTTP 缓存,第 4.2.1 节(新鲜期的计算顺序)、4.2.2 节(启发式新鲜期,典型值 10%)和 5.3 节(
Expires,无效日期按过去处理)。核对于 2026-11-20。 - web.dev,用 HTTP 缓存避免不必要的网络请求:带版本号网址用
max-age=31536000、no-cache与no-store的区别、ETag重新校验和304。核对于 2026-11-20。 - Chrome for Developers,使用高效的缓存策略提供静态资源:审计标出哪些资源,以及文件哈希的建议。核对于 2026-11-20。
- nginx,ngx_http_headers_module 和 Apache,mod_expires:
expires和ExpiresByType指令。核对于 2026-11-20。
这篇文章对你有帮助吗?
我们会根据反馈修改和补充这篇内容。
提交没有成功,请稍后再试。
谢谢你的反馈,我们会据此改进这篇内容。你已经反馈过这篇了,谢谢。

