Agent Skills
返回列表
💻

Vercel 运行时缓存 API

开发编程 更新于 2026.08.30

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

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

技能介绍

要解决什么问题

在 Vercel 上跑 Serverless Functions、路由中间件或构建步骤时,跨一次调用的状态往往只能落数据库或外部 KV,延迟和成本都偏高。框架自带的 'use cache'(无 : remote)还是实例内内存,函数冷启或扩缩后数据不共享。Vercel Runtime Cache 提供按区域隔离的临时 KV,并可用 tag 做细粒度失效,适合在单区域内跨函数共享 API 结果或计算结果。

技能如何帮你落地

本技能把 @vercel/functions 里的读写、cache.expireTag、以及 CDN + Runtime + Data 三层联动的 invalidateByTag / dangerouslyDeleteByTag 区分讲清楚,避免只清 Runtime 却以为整站 CDN 已刷新。Next.js 16+ 部分会说明 'use cache: remote' 与 Server Action 里的 updateTag、revalidateTag(tag, 'max') 等用法,并强调 单参数 revalidateTag(tag) 已弃用。还会覆盖 CLI vercel cache、给 CDN 响应打 tag,以及 Dashboard Observability → Runtime Cache 的观测入口。

适用边界与常见误区

  • Runtime Cache 的 tag 不作用于 ISR 页面;revalidatePath / Next 侧 revalidateTag 不会清 Runtime,需要同一 tag 时用 invalidateByTag 打全层。
  • 单条 2 MB、每 item 最多 64 个 tag;满了走 LRU,不是持久化存储。
  • 不适合:跨 region 共享状态、按用户差异化的请求级数据、整页 CDN 缓存策略(应走 Cache-Control / Vercel-CDN-Cache-Control)。

官方文档:Runtime Cache。

使用场景

  • CMS Webhook 触发后,用统一 tag 同时刷新 CDN、Runtime 与 Data 三层缓存
  • 多个同区域 Function 复用同一份聚合查询结果,避免每次请求都打主库
  • 预览环境与生产环境隔离缓存,新部署后仍可读旧 key,直到 TTL 或 expireTag
  • 在 Server Action 里用 updateTag 实现写后立即读一致,而不是等 CDN 自然过期

适合人员

  • 在 Vercel 部署 Next.js 16 应用、需要把远程 cache 与 revalidateTag 参数写法对齐的全栈工程师
  • 维护无框架或混合框架项目、通过 @vercel/functions 做区域级 KV 共享的后端开发者
  • 负责内容发布流水线、要在 Webhook 里选对 expireTag 与 invalidateByTag 的站点运维
  • 排查「页面已 revalidate 但 Function 仍读旧值」类问题的性能与缓存负责人