nginx中配置etag实现协商缓存的核心是“省传输”而非“省请求”,通过304响应跳过响应体下载以减少带宽消耗;需确保etag自动生成可靠、配合cache-control明确协商意图、按资源类型区分使用,并验证首/次请求的etag与304行为。

在 Nginx 中配置 ETag 实现协商缓存,核心目标不是“省请求”,而是“省传输”——当资源未变时,用 304 响应跳过响应体下载,减少带宽消耗。它特别适合 HTML 页面、未带哈希的 JS/CSS,或 CDN 边缘节点与源站之间的一致性校验。
1. 确保 ETag 自动生成且可靠
Nginx 默认对静态文件启用 etag on(基于文件修改时间 mtime 和大小),但该方式在部署时仅改内容不改时间(如 NFS 挂载、CI/CD 覆盖)会导致 ETag 不变,引发缓存误用。因此需确认:
- 配置中明确写了
etag on;,且未被etag off;或add_header ETag ""覆盖 - 静态文件由 Nginx 直接提供(
root/alias),而非通过proxy_pass;否则 ETag 来自上游,不可控 - 若使用
gzip_static或brotli_static,Nginx 会为压缩文件单独生成 ETag,行为正常,无需额外处理
2. 配合 Cache-Control 明确协商意图
仅开 ETag 不够,客户端必须知道“要来问”。需搭配强制协商的缓存策略:
- 对 HTML 或未哈希资源:设
Cache-Control: public, max-age=0, must-revalidate - 避免混用
no-cache(语义易混淆)或no-store(彻底禁用缓存) - 不要同时设置
expires与协商头冲突;max-age=0+must-revalidate是标准写法
示例配置:
location / {etag on;
add_header Cache-Control "public, max-age=0, must-revalidate";
}
3. 区分资源类型,让 ETag 发挥辅助作用
ETag 在现代前端工程中已退为“辅助角色”。真正防缓存污染靠的是构建时内容哈希命名(如 app.f3a7e7.js):
- 带哈希的资源可配长期强缓存:
Cache-Control: public, immutable, max-age=31536000 - 此时 ETag 的价值是:相同哈希文件多次访问仍可触发 304,节省带宽;CDN 或代理层也能用它做一致性比对
- 不推荐单独依赖 ETag 管理 JS/CSS 更新——哈希文件名才是工业级可靠方案
4. 验证是否生效
用 curl 或浏览器 DevTools 检查真实行为:
- 首次请求:响应含
ETag: "abc123"和200 OK - 二次请求:请求头自动带
If-None-Match: "abc123",响应应为304 Not Modified(空 body) - Chrome Network 面板 → 查看某静态资源 → Headers → Response Headers 是否有 ETag,Request Headers 是否有 If-None-Match











