防缓存过期的关键是分类配置:带哈希的静态资源设长缓存(1年+immutable),无哈希静态资源设30天,动态资源禁用强缓存并配no-cache;需精准location匹配、正确root/alias路径、合并Cache-Control头且必须验证生效。

防缓存过期不是靠“阻止缓存”,而是让缓存既高效又可靠——关键在于让浏览器只在该用缓存时用,该更新时立刻更新。核心逻辑是:文件名带哈希就大胆设长缓存,文件名固定就设短缓存或禁用强缓存,再配合正确的响应头组合。
按后缀精准匹配,避免误伤动态资源
缓存配置失效最常见的原因是 location 匹配太宽泛。绝不能在 location / 或 location ~ \.html$ 里统一加 expires,否则 HTML、API 接口也会被缓存,导致用户看到旧页面或错误数据。
- 推荐用
~*不区分大小写正则匹配静态后缀:比如location ~* \.(js|css|png|jpg|gif|woff2|svg|webp)$ - 若静态资源集中放在
/static/或/assets/目录下,优先用^~ /static/,性能更高且无正则开销 - 确保 root 或 alias 指向真实路径,否则返回 404,缓存头根本不会发出
分类型设有效期,匹配文件是否带版本标识
缓存时长不能一刀切,必须看文件名是否含内容哈希(如 app.a1b2c3.js)。哈希变了,URL 就变,浏览器自然加载新资源;哈希不变,说明内容没变,可放心缓存。
- 带哈希的 JS/CSS/字体/WebP:设
expires 1y;或expires max;,再加add_header Cache-Control "public, immutable, max-age=31536000"; - 图片、图标等稳定但无哈希的资源(如
logo.png):设expires 30d;,配合add_header Cache-Control "public, max-age=2592000"; - HTML、PHP、JSON 等动态或入口类资源:设
expires epoch;或expires -1;,并加add_header Cache-Control "no-cache, must-revalidate, max-age=0";
必须补全 Cache-Control,且只写一次
expires 指令只生成基础缓存头,现代浏览器更依赖 Cache-Control,且语义更明确。注意:add_header 在同一作用域内多次声明会覆盖,务必合并成一条。
-
immutable是关键:它告诉浏览器“这个资源永远不会变”,F5 刷新也不发条件请求(如 If-None-Match),大幅提升重复访问性能 - 没
immutable的资源,即使设了 1 年,浏览器仍可能在刷新时发起验证请求(304),增加延迟 - 不要只写
expires就完事,Cache-Control必须显式声明,且与expires值逻辑一致
改完必须验证,别信“写了就生效”
很多配置看似正确却没起作用,往往卡在验证环节。
- 先运行
nginx -t检查语法,再nginx -s reload重载 - 用
curl -I https://your.site/app.a1b2c3.js查看响应头,确认同时存在Expires和Cache-Control,且值符合预期 - 打开 Chrome DevTools → Network → 刷新页面,找一个 JS 文件,观察 Size 列是否显示
from memory cache或from disk cache - 如果没生效,排查点:location 是否命中、是否被
proxy_pass覆盖、静态文件是否真由 Nginx 直接提供(而非后端返回)


















