用途
该技能面向 Vercel 缓存问题的诊断与优化,覆盖命中率低、内容过期、重新验证过于频繁、PPR 请求仍调用函数及 ISR 读写成本等情况。
主要能力
- 区分区域 CDN 缓存、持久 ISR 缓存、函数执行与图片缓存;应用内部的数据缓存属于另一层。
- 说明 PPR 是渲染策略:静态外壳可命中 ISR 缓存,动态部分仍可能逐请求执行函数,不能据此判定缓存未命中。
- 分析缓存状态、单次请求的缓存原因与 PPR 状态,区分正常的后台刷新、标签失效和重新生成失败。
- 按团队、项目、路径、区域和标签拆分指标,将请求量与以 8 KB 为计费单位的 ISR 读写区分开。
使用方式
先查看整体缓存分布,再定位未命中集中的路径。计算可缓存流量的命中率时,排除绕过缓存及不适用的请求;编辑预览和搜索引擎爬虫可能有合理的绕过行为。随后结合响应头、CDN 请求记录、运行日志与代码中的失效调用定位原因。
优化时优先检查过短的定时刷新和作用范围过大的共享标签。按具体对象设置标签,并根据真实内容变化触发刷新。使旧内容失效与直接硬删除缓存的行为不同,后者会让下一次请求在前台等待重新生成。
限制
部分指标和请求过滤能力需要 Observability Plus 或 Priority 项目。内部缓存原因与 PPR 状态不能仅靠公开响应头取得。该技能提供诊断方法,不保证固定命中率或节省比例。