指令速查
| 指令 | 侧 | 含义 |
|---|---|---|
| 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=86400stale-while-revalidate / stale-if-error 对可用性提升明显,被 CDN 广泛支持;注意对数据一致性要求高的接口不要配。