SuperAPI AI 工具集

next-cache-components

通用与其它

查看项目

更新于 10-16 07:21

技能介绍

用途:缓存组件(Cache Components)用于在 Next.js 16+ 中启用部分预渲染(PPR),让同一路由内混合静态、缓存与动态内容。在 next.config.ts 中设置 cacheComponents: true 即可启用,它替代旧的 experimental.ppr 标志。

内容类型:一是静态内容,同步代码、导入与纯计算在构建时预渲染;二是缓存内容,用 'use cache' 包裹无需每次请求都最新获取的异步数据;三是动态内容,必须保持新鲜的运行时数据,用 Suspense 包裹以流式渲染。

主要能力:'use cache' 指令可作用于文件、组件或函数级别。cacheLife() 支持内置档位 default、minutes、hours、days、weeks、max,也可用 stale、revalidate、expire 内联配置;'use cache: remote' 使用平台提供的缓存,'use cache: private' 允许访问运行时 API。cacheTag() 为缓存打标签;updateTag() 用于同一请求内立即失效,revalidateTag() 用于后台重新验证。缓存键根据构建 ID、函数位置、可序列化参数与闭包变量自动生成。

使用方式:在需要缓存的异步函数或组件内标注 'use cache',按需调用 cacheLife 与 cacheTag;在 Server Action 中更新数据后调用 updateTag 或 revalidateTag。运行时数据约束:use cache 内不能访问 cookies()、headers() 或 searchParams;可将值提取到外部再作为参数传入,参数会进入缓存键;确需访问时可用 'use cache: private'。旧项目可将 unstable_cache 迁移为 use cache,用 cacheTag 替代 options.tags,用 cacheLife 替代 options.revalidate,无需手动维护 cache key。

限制:不支持 Edge 运行时与静态导出,需要 Node.js 服务端;Math.random()、Date.now() 等非确定性值在 use cache 内只于构建时执行一次,若需请求级随机可在缓存外用 connection() 推迟到请求时。以本资料为限,未提供计费与平台支持等更多信息。