Cache-Control 生成
指令组合 + 冲突体检 + 反向解析 + 场景预设
建议配套头会随策略变化;真正生效还要看服务器/CDN 是否透传,以及是否有更严格的中间层覆盖。
如何使用本工具
- 先选一个场景预设,左边会自动回填可见性、max-age 和布尔指令,右边即时生成完整响应头。
- 按需微调指令:max-age 支持秒 / 分 / 时 / 天换算,s-maxage、stale-while-revalidate、stale-if-error 按秒填 0 表示不输出。
- 看「配置冲突」提示,例如 no-store 配 max-age、no-cache 配 immutable 都是常见误用;下面还会给 ETag / Vary 等配套头建议。
- 已有响应头可以贴到页面下方的解析框,逐条查看每个指令的准确含义。
常见问题
Q:no-cache 是不缓存吗?
A:不是。no-cache 允许缓存,但每次复用前必须回源协商(走 If-None-Match / If-Modified-Since,命中就回 304)。真正「一点都不存」要写 no-store。这是 HTTP 缓存里最容易记反的一对指令。
Q:immutable 适合什么场景?
A:适合文件名带内容哈希的 JS / CSS,例如 app.8f3c2a.js。它告诉浏览器在 max-age 内文件内容绝不变,连用户按刷新时的条件请求都可以跳过。前提是内容一变就必须换 URL,不能靠清缓存更新同名文件。
Q:max-age 和 s-maxage 有什么区别?
A:max-age 对所有缓存生效;s-maxage 只作用于 CDN、代理这类共享缓存,且优先级更高。常见写法是 max-age=60, s-maxage=300,让浏览器一分钟过期、CDN 五分钟才回源一次。
Q:stale-while-revalidate 会不会给用户看旧数据?
A:会,这正是它的设计:缓存过期后先在指定秒数内把旧内容立刻返回,同时后台异步回源更新,下次请求就是新的。适合首页、列表这类能容忍短暂滞后的内容;下单、余额这类强一致接口不要用。
Q:生成了响应头却没生效,该查哪里?
A:先确认服务器或 CDN 真的把头透传出去了(浏览器 DevTools 的 Network 里看实际响应头),再确认中间层没有用更严格的配置覆盖它。另外 CDN 往往只认 s-maxage,且带 Set-Cookie 的响应常被默认视为 private。