用途:排查 Vercel CDN 缓存问题,包括缓存命中率、陈旧内容、重新验证行为、ISR 与 PPR,以及逐请求缓存原因(cacheReason)和成本。
主要能力:讲解 Vercel 多层缓存(CDN 缓存、ISR 缓存、函数调用、图片缓存)与请求折叠机制;解释缓存状态(x-vercel-cache:HIT、MISS、STALE、PRERENDER、REVALIDATED、BYPASS)与九种 cacheReason(cold、collapsed、error、draft_mode、prerender_bypass、crawler、stale_time、stale_tag、stale_error);区分 invalidate(stale-while-revalidate)与 dangerously-delete(硬删除);分析缓存标签与影响范围;用 Vercel CLI 的 vercel metrics 与 vercel logs 定位命中率、ISR 成本与 BYPASS 流量。
使用方式:需按团队与项目查询,例如 vercel metrics vercel.request.count -S <team> -p <project> -f "environment eq 'production'" --group-by cache_result --since 24h;用 vercel metrics schema <metric> 查看维度,-F json 输出机器可读结果;单路径可用 curl -sSI 查看 x-vercel-cache 等响应头,单请求用 vercel logs --request-id <request-id> --json。
适用场景:诊断命中率偏低、ISR 写入成本过高、标签影响范围过大、BYPASS 流量异常等。
限制:vercel metrics 需 Observability Plus;x-vercel-cache-reason 为内部头,curl 不可见,需从日志或仪表盘读取;PPR 路由命中静态外壳仍会调用函数;具体价格与配额资料未提供。