Vercel 运行时缓存 API
将以下提示词粘贴到你的 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 仍读旧值」类问题的性能与缓存负责人