html怎么做ETag条件缓存策略_html ETag条件请求缓存验证机制【最全】

云浩吖_9717

云浩吖_9717

2026-06-11

545人浏览

原创

html必须用etag而非last-modified,因后者精度仅秒级且易被构建工具误改mtime,导致无效刷新;etag基于内容哈希生成,内容不变则标识不变,保障协商准确。

html怎么做etag条件缓存策略_html etag条件请求缓存验证机制【最全】

HTML 不适合走强缓存,必须用 ETag 配合 no-cache 实现条件请求——否则用户刷新看到的可能是旧 HTML,连带加载错版本的 JS/CSS,直接白屏或样式崩溃。

为什么 HTML 必须用 ETag 而不是 Last-Modified

Last-Modified 基于文件修改时间,精度只有秒级,且容易被构建工具(如 touch、rsync)意外更新;哪怕 HTML 内容完全没变,只要 mtime 变了,服务端就会误判为“已更新”,返回 200 + 新内容,浪费带宽又破坏缓存复用。

ETag 用内容哈希(比如 md5(fileContent))生成才可靠:内容不变,ETag 就不变,哪怕文件重命名、部署时间戳重写、甚至跨服务器同步,协商结果依然准确。

常见错误现象:

  • 本地开发用 file:// 打开 HTML,看不到任何 ETag 或协商行为(根本没 HTTP 头)
  • Nginx 默认的 etag on 是基于 mtime + size,不抗 touch,线上要手动覆盖
  • CDN 或反向代理(如 Cloudflare、Nginx upstream)清掉了原始 ETag,导致后续请求始终返回 200

Nginx 中正确启用 ETag 协商缓存

关键不是“加 ETag”,而是确保它由内容决定,并配合正确的 Cache-Control 指令触发协商流程。

推荐配置(放在匹配 HTML 的 location 块里):

Pictory
Pictory

一款面向内容营销的视频制作工具,可将文章、脚本和长视频等内容转化为短视频,并提供剪辑、字幕等 AI 辅助能力。

下载
location ~* \.html$ {
    add_header Cache-Control "no-cache, must-revalidate";
    add_header ETag "";
    # 禁用 Nginx 默认的 mtime+size ETag
    etag off;
    # 若后端能输出 Content-MD5,也可用它生成 ETag(更可控)
}

说明:

  • add_header ETag "" 让 Nginx 自动生成基于响应体的哈希值(需开启 etag off 避免冲突)
  • no-cache 明确告诉浏览器:别走强缓存,每次都要发条件请求;must-revalidate 强制校验,绕过用户手动点击“强制刷新”的干扰
  • 不要写 max-age=0 —— 它语义模糊,有些旧客户端会降级成 no-store 行为
  • 若用 Hugo/Jekyll 等静态生成器,可提前在构建时注入哈希到 HTML 文件名(如 index.a1b2c3.html),再配 Cache-Control: immutable,彻底跳过协商——但前提是 HTML 真的不带动态数据

怎么验证 ETag 协商是否生效

别信地址栏回车或 F5,它们可能走内存缓存或跳过验证。真实验证只看 Network 面板里的 HTML 请求:

  • Status 列显示 304 Not Modified → 协商成功,浏览器用了本地 HTML 缓存
  • Status 是 200 OK 且 Response Headers 里有 ETag → 首次请求或内容真变了
  • Status 是 200 from memory cache 或 200 from disk cache → 强缓存生效了,Cache-Control 配错了,HTML 被缓存了
  • Request Headers 里没有 If-None-Match → 浏览器根本没发协商请求,no-cache 没生效,或者被中间层(CDN、代理)覆盖了响应头

额外检查点:打开 DevTools → Application → Cache Storage,确认里面没存 HTML(HTML 不该进 Cache API 或 HTTP Cache 的强缓存区)。

SPA 场景下 ETag 的特殊风险

单页应用的 HTML 通常是“壳”,真正逻辑在 JS 里;如果 HTML 本身用了 ETag 协商,但 JS/CSS 用了长缓存(max-age=31536000),就可能出现 HTML 是新版、JS 还是旧版的情况——页面初始化失败、路由报错、API 调用字段缺失。

解决思路不是禁用 ETag,而是保证版本一致性:

  • 所有资源(HTML + JS + CSS + 字体)都用内容哈希命名,HTML 中引用的 JS 路径也带 hash(如 main.a1b2c3.js)
  • HTML 响应头设 Cache-Control: no-cache + ETag,JS/CSS 设 Cache-Control: public, immutable, max-age=31536000
  • 避免在 HTML 中内联关键 JS(比如初始化脚本),否则它的版本无法随文件名 hash 控制,只能靠 ETag 全量校验

最易被忽略的一点:很多 CI/CD 流程会在部署后自动 touch 所有 HTML 文件,这会让基于 mtime 的 ETag 失效——与其修复 ETag,不如直接切到内容哈希生成方式,或改用指纹化文件名 + immutable 策略。

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.14

5055

7

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

2023.06.21

2952

4

html网页制作
html网页制作

html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.31

2590

5

html空格
html空格

html空格是一种用于在网页中添加间隔和对齐文本的特殊字符,被用于在网页中插入额外的空间,以改变元素之间的排列和对齐方式。本专题为大家提供html空格的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.01

2639

5

html是什么
html是什么

HTML是一种标准标记语言,用于创建和呈现网页的结构和内容,是互联网发展的基石,为网页开发提供了丰富的功能和灵活性。本专题为大家提供html相关的各种文章、以及下载和课程。

2023.08.11

4579

6

html字体大小怎么设置
html字体大小怎么设置

在网页设计中,字体大小的选择是至关重要的。合理的字体大小不仅可以提升网页的可读性,还能够影响用户对网页整体布局的感知。php中文网将介绍一些常用的方法和技巧,帮助您在HTML中设置合适的字体大小。

2023.08.11

2581

3

html转txt
html转txt

html转txt的方法有使用文本编辑器、使用在线转换工具和使用Python编程。本专题为大家提供html转txt相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.31

2369

3

html文本框代码怎么写
html文本框代码怎么写

html文本框代码:1、单行文本框【<input type="text" style="height:..;width:..;" />】;2、多行文本框【textarea style=";height:;"></textare】。

2023.09.01

2168

6

HTML嵌入CSS样式的方法
HTML嵌入CSS样式的方法

HTML嵌入CSS样式的方法有内联样式、内部样式表和外部样式表。本专题为大家提供CSS样式相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.20

2128

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.6万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.2万人学习