Agent Skills
返回列表
🔒

Vercel 多层缓存

IT 运维与安全 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/vercel-vercel-plugin-cdn-caching。

技能介绍

你在排查什么问题

在 Vercel 上跑 Next.js(或 SvelteKit、Nuxt、Astro)时,页面偶发变慢、ISR 账单里的 write_units 突然偏高,或 x-vercel-cache 一直是 MISS/REVALIDATED,这些往往和 CDN、ISR、PPR 分层行为、revalidate 策略有关,而不是单纯「函数太慢」。

技能覆盖的核心能力

本技能把访客请求到后端的链路讲清楚:PoP → 区域 CDN → ISR cache → Function,以及各层命中时是否计费(CDN 读写免费,ISR 按 8 KB 计费)。重点包括:

  • PPR:静态壳在 ISR 里,动态洞按请求由函数流式填充;有洞路由在 shell HIT 时仍会调函数。
  • 失效方式:invalidate / revalidateTag 走 stale-while-revalidate(STALE);dangerously-delete / updateTag 会前台再生(REVALIDATED)。
  • 可观测性:用 cache_result 看整体命中率;用 cacheReason(如 cold、stale_tag、stale_error)区分 MISS/STALE 根因;PPR 路由可看 ppr_state(Static / Partial / Dynamic)。
  • 排障路径:vercel metrics 按 cache_result、path_type、route 拆分;ISR 成本重点看 write_units 与 tag 的 blast radius,并在代码里搜 revalidateTag、invalidateByTag 等调用点。

边界与注意点

Runtime Cache(函数与后端之间的数据缓存)是另一层,本技能主要指向边缘与 ISR/PPR。x-vercel-cache-reason 等细节需在 Vercel Logs / Dashboard 查看,不能靠普通 curl 当唯一依据。BYPASS 在 Draft Mode、爬虫 UA 等场景是预期行为,不应误当成配置错误。

使用场景

  • 生产环境 ISR 命中率下降,需用 metrics 判断 MISS 集中在哪些 route 或 path_type
  • CMS Webhook 频繁触发 revalidateTag,导致 write_units 暴涨,要查共享 tag 的 blast radius
  • PPR 页面对用户快但对爬虫 BYPASS,需确认 crawler 与 Draft Mode 是否为预期 BYPASS
  • 短 revalidate 间隔导致 stale_time 过多,想改成按 product-${id} 的按需失效

适合人员

  • 负责 Vercel 计费的平台工程师,需要把 write_units 与 revalidation 频率对应到具体 route 和 tag
  • 维护 Next.js ISR/PPR 站点的全栈开发者,要读懂 x-vercel-cache 与 cacheReason 的差异
  • SRE 在流量尖峰后排查冷启动与 request collapsing,区分 cold MISS 与 collapsed MISS
  • 内容中台开发在接 Webhook 时设计 cache tag,避免一个 blogPost 标签拖垮全站命中率