html缓存命中率无法被javascript直接监测,但可通过network面板的status(如“from cache”或“304”)、size字段、ttfb,以及performance api的transfersize等信号交叉验证,准确判断强缓存或协商缓存是否生效。

HTML 缓存命中率无法用 JavaScript 直接读取,也没有浏览器 API 返回“本次 HTML 是否命中强缓存”,但你可以通过 Network 面板信号、Performance API 字段和服务端日志三者交叉验证,准确判断并量化命中行为。
看 Chrome DevTools Network 面板里的 Status 和 Size
这是最快速、最可靠的实操入口。刷新页面后,在 Network 标签页中筛选 index.html(或你主 HTML 的实际路径),重点关注三项:
- Status 列显示
(from cache)或(from disk cache):说明未发请求,命中强缓存(Cache-Control: max-age或Expires有效) - Status 是
304且 TTFB If-None-Match/If-Modified-Since),服务端确认未变,属于“再验证命中” - Status 是
200且 Size 列为具体字节数(如12.4 KB):未命中,完整下载 HTML —— 这是命中率为 0 的明确信号 - 额外注意
X-Cache响应头:若值为HIT(Cloudflare)、HIT from cloudfront(AWS)或MISS,可确认 CDN 层是否叠加生效
用 window.performance.getEntriesByType("navigation") 捕获 transferSize
该 API 能拿到本次页面加载的真实网络传输数据,关键字段是 transferSize:
- 若
transferSize === 0且responseStatus === 200:大概率命中强缓存(注意:部分浏览器在 304 场景下也返回 0,需结合 Status 判断) - 若
transferSize显著小于首次加载值(比如从 15KB 降到 234B),且responseStatus === 304:说明协商缓存生效 - 不要只看
encodedBodySize:它表示压缩后响应体大小,未命中时也可能很小(如空响应),必须和transferSize+responseStatus联合判断
和服务端日志联动分析 $upstream_http_cache_status
前端监控有盲区,单靠浏览器信号会漏掉反向代理/CDN 层的真实决策。以 Nginx 为例,必须在日志格式中显式记录缓存状态:
- 在
nginx.conf的log_format中加入$upstream_http_cache_status - 确保后端(如 PHP/FastCGI)或上游(如 Varnish)正确设置了该响应头
- 日志中出现
HIT/MISS/EXPIRED/BYPASS字样,才是真正权威的缓存结果 - 把该字段和前端上报的
domContentLoadedEventEnd时间戳打点关联:如果服务端标记HIT但前端耗时仍高,问题不在缓存,而在 JS 执行或布局渲染阶段
真正难的不是识别单次命中,而是持续统计——浏览器不提供聚合接口,你也无法靠前端代码可靠地累加计数。必须把 Network 面板观察、Performance API 抽样、服务端日志三者对齐,才能得出可信的命中率区间。忽略任意一环,都可能把 304 当成未命中,或把 CDN HIT 误判为源站未缓存。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











