HTML缓存必须由后端精确控制响应头，并与CDN、浏览器分层协同；若配置不当（如CDN覆盖、Nginx全局头、中间件顺序错误或平台硬编码策略），即使Node.js写了res.set('Cache-Control', 'no-cache')，仍可能被忽略，导致用户持续访问旧版本。

HTML 缓存不能靠后端“生成就完事”，必须由后端精确控制响应头，且要和 CDN、浏览器分层协同——否则发版后用户刷十次还是旧页面。

为什么后端写的 Cache-Control 可能被忽略

很多开发者在 Node.js（如 Express）里写了 res.set('Cache-Control', 'no-cache')，但 curl 一看响应头里还是 max-age=86400。原因通常是：

• CDN 默认开启“自动 HTML 缓存”，会覆盖源站响应头（Cloudflare、阿里云、腾讯云都默认开）
• 反向代理（如 Nginx）配置了全局 add_header Cache-Control，优先级高于后端代码
• 后端框架中间件顺序错位：比如压缩中间件或日志中间件在缓存头设置之后执行，意外覆写了头
• 某些部署平台（如 Vercel、Netlify）对 index.html 有硬编码缓存策略，后端代码根本没机会生效

后端该设什么值？no-cache 不等于“不缓存”

no-cache 的真实含义是“每次用前必须验证”，它不是禁用缓存，而是启用协商缓存流程。配合 ETag 才真正可控：

anything-to-html

将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。

下载

• ✅ 正确组合：Cache-Control: no-cache, must-revalidate + ETag（内容哈希生成）
• ❌ 错误写法：Cache-Control: max-age=0 —— 语义模糊，部分 CDN 会转成强缓存逻辑
• ❌ 避免混用：no-cache 和 Expires 同时存在时，后者被忽略；但若 CDN 清洗了 Cache-Control 却保留了 Expires，反而引发意外强缓存
• Node.js 示例（Express）：

  app.get('/index.html', (req, res) => {
    const html = fs.readFileSync('./dist/index.html', 'utf8');
    res.set('ETag', md5(html)); // 必须基于内容，不能用时间戳
    res.set('Cache-Control', 'no-cache, must-revalidate');
    res.send(html);
  });

后端如何避免静态资源版本错配

SPA 场景下，index.html 被缓存太久，会导致它引用的 main.abc123.js 已更新，但 HTML 还在拉旧的 main.def456.js 入口——结果白屏或报错。

立即学习“前端免费学习笔记（深入）”；

• 关键原则：HTML 缓存周期必须短于任何 JS/CSS 文件的生命周期（哪怕它们带 hash）
• 推荐策略：HTML 设 Cache-Control: no-cache，JS/CSS 设 Cache-Control: public, immutable, max-age=31536000
• 后端可加一层校验：在返回 HTML 前，读取当前构建产物 manifest.json，把 JS/CSS URL 注入模板，再生成 ETag（例如 ETag: "html+manifest-hash"），确保 HTML 和资源版本原子一致
• 注意：如果后端渲染（SSR），需确保每次请求都读最新构建产物，而不是缓存了旧 HTML 字符串

调试时最容易漏掉的三个点

你改了后端代码、清了 CDN 缓存、刷新了浏览器，还是看到旧 HTML？大概率卡在这三处：

• CDN 缓存 key 包含 Accept-Encoding：gzip 和 brotli 版本被当两个资源，你只清了 gzip 的缓存，br 版本还在返旧 HTML
• 浏览器 DevTools Network 面板里勾了 Disable cache，你以为在测真实缓存行为，其实完全绕过了所有逻辑
• 用了多子域名（如 app.example.com 和 www.example.com），CDN 缓存 key 没包含 Host，导致一个域名更新了，另一个还在用共享的旧 HTML 缓存