nginx提升静态资源缓存效率的核心是etag与last-modified配合cache-control实现精准条件验证:默认已启用,需确认未被etag off或if_modified_since off禁用,结合max-age与immutable等策略控制校验时机,并通过curl或devtools验证304响应是否生效。

在 Nginx 中,通过缓存校验提升静态资源读取效率,核心是减少重复传输、避免无效请求,并让浏览器和中间代理合理复用已缓存内容。关键不在于“多缓存”,而在于“缓存有据可依”——即利用 ETag 和 Last-Modified 配合 Cache-Control 实现精准的条件验证。
启用强校验:ETag 与 Last-Modified 必须开启
Nginx 默认已启用 ETag(基于文件 inode/mtime/size 生成)和 Last-Modified(取文件修改时间),但需确认未被显式关闭。若使用 etag off; 或 if_modified_since off;,校验机制将失效。
- 检查配置中是否误禁用了这两项(尤其在反向代理或自定义 location 块中)
- 静态资源目录建议统一放在独立 location 块中,例如:
location ~* \.(js|css|png|jpg|gif|ico|woff2?)$ {<br> etag on;<br> if_modified_since before;<br>} - 注意:
if_modified_since before表示仅当客户端请求头含If-Modified-Since时才返回该头;设为exact可强制始终返回,便于调试
配合 Cache-Control 控制校验触发时机
浏览器是否发起条件请求(如带 If-None-Match 或 If-Modified-Since),取决于本地缓存是否过期。因此必须设置合理的 Cache-Control:
- 对长期不变资源(如带哈希名的 JS/CSS),用
Cache-Control: public, max-age=31536000, immutable - 对可能更新但变动不频繁的资源(如 logo.png),用
Cache-Control: public, max-age=86400, must-revalidate - 避免只设
max-age=0或no-cache却不配校验头——这会强制每次发完整请求,失去校验意义
验证校验是否生效的实操方法
真正起效需要客户端和服务端双向配合。可通过以下方式快速验证:
- 用 curl 模拟首次请求,记录响应头中的
ETag和Last-Modified:curl -I https://example.com/style.css - 再次请求并带上校验头:
curl -H "If-None-Match: \"abc123\"" -I https://example.com/style.css,若返回304 Not Modified,说明校验成功 - Chrome DevTools → Network → 点击资源 → Headers 标签页,查看 Request Headers 是否含
If-None-Match,Response Headers 是否为304
注意静态资源路径与缓存一致性
如果前端构建未做内容哈希(如文件名始终为 app.js),即使加了 long cache,更新后用户仍可能加载旧缓存。此时校验虽能避免带宽浪费,但无法解决“缓存脏数据”问题。
- 推荐做法:构建时生成带内容哈希的文件名(如
app.a1b2c3.js),配合immutable+ 长期 max-age - 若无法改名,可结合
Cache-Control: no-cache(注意不是no-store),强制每次校验,靠 ETag 确保内容新鲜 - Nginx 自身不参与内容比对,ETag 由文件元信息生成;若资源通过 rsync 或 cp 覆盖但 mtime 不变,ETag 也不会变——此时需清空缓存或重启 nginx(极端情况下 touch 文件更新 mtime)











