SuperAPI AI 工具集

runtime-cache

部署与运维

查看项目

更新于 10-16 07:28

技能介绍

用途:该技能提供 Vercel Runtime Cache 的专业使用指导。Runtime Cache 是面向无服务器计算的分区域临时键值缓存,可从 Vercel Functions、Routing Middleware 和 Builds 访问,支持基于标签的细粒度失效。

主要能力:按区域隔离,每个 Vercel 区域有独立缓存;按项目及部署环境(预览/生产)隔离;缓存数据可跨部署保留,通过 TTL 或 expireTag 失效;有固定存储上限,满时按 LRU 淘汰;框架无关,通过 @vercel/functions 使用。核心 API 包括 getCache、cache.set(支持 ttl、tags、name)、cache.get、cache.delete、cache.expireTag。另有 invalidateByTag 与 dangerouslyDeleteByTag,可清理 CDN、Runtime Cache 和 Data Cache 三层。CDN 缓存标签可通过 addCacheTag 或 Vercel-Cache-Tag 响应头添加。还包含 Next.js 16+ 集成,如 use cache: remote、cacheLife、cacheTag 及 updateTag、revalidateTag 等失效 API;CLI 命令如 vercel cache purge、vercel cache invalidate --tag、vercel cache dangerously-delete --tag。

使用方式:通过 @vercel/functions 导入 getCache 并调用相应方法;Next.js 使用 use cache: remote 将数据存入 Runtime Cache。限制与注意:单项 2 MB,Runtime Cache 每项最多 64 个标签,CDN 每项最多 128 个,标签最长 256 字节,批量 REST 调用每次最多 16 个标签,标签区分大小写且不能含逗号。Runtime Cache 标签不作用于 ISR 页面;expireTag 仅作用于 Runtime Cache,Next.js 的 revalidatePath/revalidateTag 不会使其失效。Next.js 16 中单参数 revalidateTag(tag) 已弃用。框架级页面缓存、持久存储、跨区域共享状态等场景不宜使用。官方文档:https://vercel.com/docs/runtime-cache。