React / 系统课时

理解请求缓存

理解请求缓存

同一个 fetch 看起来只是一次 HTTP 请求,但在 Next.js App Router 中还会受到请求去重和持久数据缓存的影响。本课把这两层机制拆开,并用显式配置说明什么时候要复用数据、什么时候必须读取最新结果。

学习目标

  • 区分一次渲染内的请求去重与跨请求复用的 Data Cache
  • 能用 cache: 'force-cache'、cache: 'no-store' 和 next.revalidate 表达数据新鲜度
  • 能识别“开发环境看起来没刷新”和“生产缓存策略”之间的差异

先把请求去重和持久缓存分开

在当前 App Router 中,普通服务端 fetch 不应被理解成“默认永久缓存”。相同 URL 和选项的 GET/HEAD 请求,在一次 React 服务端渲染中可以被自动去重;但这层复用只覆盖当前渲染。跨多个用户请求继续复用数据,则要显式进入 Next.js 的 Data Cache。

机制 作用范围 主要目的
请求去重 单次服务端渲染 避免组件树里重复请求同一数据
Data Cache 多次请求之间 减少对上游 API 或数据源的重复访问
no-store 不进入持久 Data Cache 每次请求都读取最新数据
revalidate 持久缓存但限制寿命 在性能与新鲜度之间折中

Next.js 请求缓存层次

用 fetch 明确写出新鲜度需求

以下是片段示例,可放在 Server Component 使用的数据函数中。三个函数故意访问相同资源,只改变缓存策略,以便对比行为;示例地址需要替换为项目真实 API。

ts
const API_URL = 'https://example.com/api/posts/1'

export async function getCachedPost() {
  const response = await fetch(API_URL, { cache: 'force-cache' })
  if (!response.ok) throw new Error('Failed to fetch cached post')
  return response.json()
}

export async function getFreshPost() {
  const response = await fetch(API_URL, { cache: 'no-store' })
  if (!response.ok) throw new Error('Failed to fetch fresh post')
  return response.json()
}

export async function getRevalidatedPost() {
  const response = await fetch(API_URL, {
    next: { revalidate: 60 },
  })
  if (!response.ok) throw new Error('Failed to fetch revalidated post')
  return response.json()
}

预期结果

text
getCachedPost:请求结果可进入 Data Cache,后续请求可复用缓存
getFreshPost:不进入持久 Data Cache,每个新的服务端请求都重新访问数据源
getRevalidatedPost:缓存寿命最多为 60 秒,过期后由后续访问触发重新获取

cache: 'force-cache' 适合更新很少、允许复用的数据;cache: 'no-store' 适合账户余额、权限判断、实时库存等必须尽量新鲜的数据;next.revalidate 适合文章列表、商品目录等允许短时间陈旧的数据。

注意 Next.js 16 的 Cache Components

如果项目启用了 cacheComponents: true,主要缓存模型会转向 use cache 与 cacheLife,此时应优先围绕“哪些组件或函数允许复用”设计缓存,而不是继续依赖路由级旧配置。本课中的 fetch 选项仍有助于理解请求语义,但不要把不同缓存模型的规则混在一起。

片段示例:启用 Cache Components 后,可以直接给数据函数声明缓存作用域和寿命。

ts
import { cacheLife } from 'next/cache'

export async function getProducts() {
  'use cache'
  cacheLife('hours')

  const response = await fetch('https://example.com/api/products')
  if (!response.ok) throw new Error('Failed to fetch products')
  return response.json()
}

预期结果

text
getProducts() 的结果进入缓存作用域,并按 hours 生命周期策略管理复用与再验证。
不同参数会形成不同缓存键,不会把不同参数的数据混成同一条缓存。

开发环境里不要只凭刷新判断缓存

开发模式会为了热更新体验临时复用部分 Server Component 的 fetch 结果,而浏览器硬刷新又可能携带禁止缓存的请求头,因此“我刷新后数据有没有变化”并不是可靠的缓存验证方式。调试时先看代码里的缓存声明,再用生产构建或上游请求日志验证真实访问次数。

缓存的核心不是“越多越快”,而是给每类数据写清允许陈旧多久。用户私有或强实时数据优先保持新鲜,公共且更新较慢的数据再选择持久缓存或定时再验证,这样性能优化才不会以错误数据为代价。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

理解请求缓存

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通