Cache-Status：HTTP 缓存可观测与调试实践

---

title: Cache-Status：HTTP 缓存可观测与调试实践

keywords:

• Cache-Status
• 缓存命中
• 代理/CDN
• 诊断
• 观测

description: 介绍 Cache-Status 响应头的字段与语义，观测代理/CDN/浏览器的缓存命中、回退与验证行为，辅助定位缓存策略问题并优化命中率。

categories:

• 文章资讯
• 技术教程

---

概述

Cache-Status 是用于暴露中间缓存（代理/CDN）或服务器的缓存行为的响应头，包含命中/回退/验证状态、存储时间与原因等信息，帮助进行端到端缓存调试与优化。

示例

Cache-Status: cdn; hit; ttl=120; age=30; key=URL; detail="swr"

工程建议

• 端到端：与 Age/Via/Cache-Control 联合分析；对不同层的 Cache-Status 进行汇总。
• 策略调整：根据命中与回退原因优化 TTL、变体（Vary）与键；避免缓存碎片化。
• 观测与报表：记录命中率、失败与刷新；在变更前进行灰度与 A/B。

参考与验证

• IETF 草案（Cache-Status）：https://datatracker.ietf.org/doc/draft-ietf-httpbis-cache-header-fields/
• Fastly/Cloudflare 文档：各厂商的 Cache-Status 说明