缓存架构
优先级: P1(高)
Next.js 有 4 种不同的缓存层。理解它们可以防止出现数据陈旧错误。
实施指南
- Next.js 15+ 标准:对于 API 调用,使用
fetch+revalidate: number或cache: 'force-cache'。对于自定义数据存储,使用unstable_cache或新的'use cache'(实验性)。 - 层:区分数据缓存(跨请求持久化)和请求记忆化(React 生命周期特定)。使用 React 的
cache()在单个渲染中去重 fetch 调用。 - 失效:在数据变更后使用
revalidatePath('/'),或使用revalidateTag('tag-name')进行细粒度缓存清除。 - 客户端缓存:理解路由器缓存(客户端内存中的缓存)及其 30 秒至分钟的生存期。使用
router.refresh()清除它。 - 静态资源:利用
generateStaticParams在构建时预渲染静态路由。对于定期更新的内容,使用 ISR(增量静态再生)。 - 流式渲染:将
Suspense与fetch触发相结合,防止慢数据阻塞整个页面渲染。 - Next.js 16+:在可用的情况下,优先使用
'use cache'和cacheLife()而非revalidate: number,以实现确定性缓存。
| 层 | 位置 | 控制 |
|---|---|---|
| 请求记忆化 | 服务器 | React cache() |
| 数据缓存 | 服务器 | 'use cache', revalidateTag |
| 全路由缓存 | 服务器 | 静态预渲染 |
| 路由器缓存 | 客户端 | router.refresh() |
实施细节
请参阅 缓存组件和 PPR 了解详细的键生成、闭包约束和失效策略。
反模式
- Next.js 16+ 中不要使用
unstable_cache:应改用'use cache'指令 +cacheLife()。 - 不要对服务器数据使用
router.refresh():优先使用revalidateTag()进行有目标的缓存清除。 - 不要在路由级别缓存用户特定数据:将个人数据包裹在
<Suspense>中并使用'use cache'。 - 不要使用没有标签的长期缓存:分配
cacheTag()以实现细粒度失效控制。