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 |
持久缓存但限制寿命 | 在性能与新鲜度之间折中 |

用 fetch 明确写出新鲜度需求
以下是片段示例,可放在 Server Component 使用的数据函数中。三个函数故意访问相同资源,只改变缓存策略,以便对比行为;示例地址需要替换为项目真实 API。
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()
}预期结果
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 后,可以直接给数据函数声明缓存作用域和寿命。
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()
}预期结果
getProducts() 的结果进入缓存作用域,并按 hours 生命周期策略管理复用与再验证。
不同参数会形成不同缓存键,不会把不同参数的数据混成同一条缓存。开发环境里不要只凭刷新判断缓存
开发模式会为了热更新体验临时复用部分 Server Component 的 fetch 结果,而浏览器硬刷新又可能携带禁止缓存的请求头,因此“我刷新后数据有没有变化”并不是可靠的缓存验证方式。调试时先看代码里的缓存声明,再用生产构建或上游请求日志验证真实访问次数。
缓存的核心不是“越多越快”,而是给每类数据写清允许陈旧多久。用户私有或强实时数据优先保持新鲜,公共且更新较慢的数据再选择持久缓存或定时再验证,这样性能优化才不会以错误数据为代价。