首页/网络/协议速查/Cache-Control 指令全表
HTTP 头与缓存70 条

Cache-Control 指令全表

请求与响应两侧的全部高频指令与语义,一家一张表。

协议速查网络更新于 2026-10-12

指令速查

指令侧含义
max-age=N双新鲜期 N 秒(响应侧)/ 可接受的最大年龄(请求侧)
s-maxage=N响应共享缓存专用新鲜期,覆盖 max-age
no-cache双每次使用前必须再验证
no-store双完全禁止存储
private响应仅浏览器可存,共享缓存禁止
public响应可被共享缓存存储(即使通常私有)
must-revalidate响应过期后禁止拿陈旧副本,必须再验证
immutable响应新鲜期内绝不再验证
stale-while-revalidate=N响应过期后 N 秒内可先用旧副本并后台刷新
stale-if-error=N响应回源出错时 N 秒内可用旧副本兜底
no-transform双禁止代理改写内容(压缩/转码)

组合示例

组合示例
Cache-Control: public, max-age=60, stale-while-revalidate=300, stale-if-error=86400
stale-while-revalidate / stale-if-error 对可用性提升明显,被 CDN 广泛支持;注意对数据一致性要求高的接口不要配。

数据来源与参考

  • RFC 9111 §5.2(指令定义)
  • RFC 5861(stale 扩展指令)

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌