html文件不应设max-age=3600,因其含动态内容(如csrf token、未读数),强缓存会导致用户长期无法获取更新;应配no-cache或max-age=0,must-revalidate强制协商验证,静态资源则需哈希命名+immutable+max-age=31536000实现安全长期缓存。

HTML 文件本身不该靠“缓存”来减少请求,而应靠「不强缓存 + 协商验证」来避免错误内容;真正该长期缓存的是它引用的 CSS/JS/图片等静态资源。
为什么不能给 index.html 设 max-age=3600
HTML 是页面入口,通常含动态内容:登录态、CSRF token、时间戳、未读数。设 max-age=3600 会导致浏览器一小时内完全不发请求——哪怕你刚修复了一个按钮跳转 bug,用户仍卡在旧 HTML 里。更糟的是,如果服务端没配 ETag 或 Last-Modified,连协商缓存都失效,用户就彻底拿不到更新。
- 现象:刷新后按钮文案没变、表单提交报 403(token 过期)、价格显示滞后
- 根本原因:
Cache-Control: public, max-age=3600触发强缓存,跳过所有服务器交互 - 替代方案:用
no-cache或max-age=0, must-revalidate,强制每次走协商流程
正确配置 HTML 缓存头(Nginx / Express / 静态托管)
所有生效方式都依赖服务端响应头,<meta http-equiv="Cache-Control"> 在 Chrome/Firefox/Safari 中完全被忽略,写了等于没写。
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图,自动匹配视觉风格。触发场景:文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
- Nginx:
location = /index.html { add_header Cache-Control "no-cache"; } - Express:
res.set("Cache-Control", "no-cache");(放在对应路由 handler 中) - Vercel:
_headers文件里加/index.html→cache-control: no-cache - 注意:CDN(如 Cloudflare)可能覆盖源站头,需检查响应中是否真有
Cache-Control,并确认x-cache头未命中边缘缓存
怎么让静态资源真正长期缓存且不脏
提速的关键不在 HTML,而在它加载的 main.a1b2c3.js、app.f4e5d6.css 这类文件。它们体积大、变动少,适合激进缓存,但必须满足两个前提:
- 构建时生成内容哈希文件名(如 Webpack 的
[contenthash]),确保内容一变 URL 就变 - 服务端配
Cache-Control: public, immutable, max-age=31536000——immutable告诉浏览器“这个 URL 永远不会变内容”,后续访问可跳过If-None-Match请求 - Nginx 示例:
location ~* \.(js|css|png|jpg|woff2)$ { expires 1y; add_header Cache-Control "public, immutable"; } - 漏掉哈希命名却加
immutable?改了 JS 内容但 URL 不变,用户永远拿不到新版本
如何验证缓存是否按预期工作
别信普通刷新(F5)或地址栏回车——它们可能走内存缓存或触发非标准校验。真实验证只看 Network 面板的三处:
-
Size列显示from memory cache或from disk cache:说明强缓存生效(对 HTML 来说通常是错的) -
Status是304 Not Modified:协商缓存生效,服务端确认未变,复用本地副本 -
Response Headers里有没有Cache-Control?值是否符合预期?有没有被 CDN 或反向代理覆盖? - 强制刷新(Ctrl+Shift+R)会跳过所有缓存,仅用于排除干扰,不是验证手段
最容易被忽略的是缓存链路断裂:你 Nginx 配了 no-cache,但 CDN 后台默认开启 HTML 缓存,结果用户看到的是 CDN 缓存的旧 HTML;或者构建没打哈希,却给 JS 配了 immutable,导致更新完全不可见。调问题时得一层层查响应头,而不是只信自己写的那一行配置。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










