React / 系统课时

配置重新验证

配置重新验证

重新验证适合“内容需要更新,但没有必要每次请求都重新计算”的页面。你可以给缓存设置时间窗口,让大多数请求继续获得快速的静态响应,并在缓存变旧后由后续请求触发后台刷新,从而在性能和数据新鲜度之间取得平衡。

学习目标

  • 理解时间重新验证与普通定时任务的区别
  • 使用 revalidate 为 App Router 页面设置刷新间隔
  • 在生产模式下观察缓存从命中、过期到刷新后的变化

重新验证不是定时任务

时间重新验证中的数字表示缓存最多保持新鲜的时间窗口,而不是服务器每隔固定秒数主动运行一次任务。缓存过期后,通常要等下一次请求到来,Next.js 才会返回已有的旧结果并在后台生成新版本;新版本成功后,再替换旧缓存。

Next.js 时间重新验证的缓存时间线

这类行为非常适合博客、商品目录、帮助中心或公开榜单:允许短时间看到旧内容,但希望避免每个请求都访问数据库或外部 API。若业务要求变更后立即可见,应使用按需重新验证;若要求每个请求都是最新值,则应改用动态渲染。

给页面配置重新验证时间

以下示例适用于 App Router 且没有启用 cacheComponents: true 的缓存模型。export const revalidate = 60 表示该路由的默认重新验证周期为 60 秒,而且这个值必须能被静态分析,因此直接写数字最稳妥。

片段示例放在现有项目的 app/blog/page.tsx,数据来自可直接访问的公开 API。

tsx
interface Post {
  id: string | number
  title: string
}

export const revalidate = 60

export default async function BlogPage() {
  const response = await fetch('https://api.vercel.app/blog')

  if (!response.ok) {
    throw new Error('Failed to fetch posts')
  }

  const posts = (await response.json()) as Post[]

  return (
    <main>
      <h1>Blog Posts</h1>
      <ul>
        {posts.map((post) => (
          <li key={post.id}>{post.title}</li>
        ))}
      </ul>
    </main>
  )
}

预期结果

text
首次请求:生成并缓存 /blog
60 秒内:后续请求复用缓存
超过 60 秒后的首个请求:可先返回旧缓存,并触发后台重新生成
重新生成成功后:后续请求获得新缓存

这里的 60 秒不是“保证第 60 秒自动刷新”。如果页面在过期后一直无人访问,就不会因为时间到了而凭空产生一次请求。

用生产模式观察缓存

开发模式中的页面通常按请求执行,无法准确模拟生产缓存。先构建并启动生产服务器,再请求页面并检查响应头。

bash
npm run build
npm start

预期输出

text
▲ Next.js <VERSION>
- Local: http://localhost:<PORT>
✓ Ready in <TIME>

另开终端发送真实 GET 请求并只保留响应头:

bash
curl -s -D - http://localhost:<PORT>/blog -o /dev/null

预期输出

text
HTTP/1.1 200 OK
x-nextjs-cache: <VALUE>

<PORT> 以启动日志为准,<VALUE> 可能随请求阶段出现 MISS、HIT、STALE 或 REVALIDATED。连续请求并跨过重新验证窗口后,重点观察状态如何变化,而不是期待每次都得到同一个值。

选择合理的时间窗口

时间越短,内容越新鲜,但后台重新生成和数据源访问会更频繁;时间越长,缓存命中率更高,但用户看到旧数据的窗口也更长。通常应从业务允许的最大陈旧时间反推,而不是随手写一个很小的数字。

  • 分钟级可接受的公开内容,可以从几分钟到一小时开始评估。
  • 内容更新事件明确时,优先用 revalidatePath 或标签失效,而不是频繁轮询式重新验证。
  • 库存、在线状态等要求接近实时的数据,不应靠极短的 revalidate 冒充实时系统,应切换到动态渲染或专门的实时数据方案。

同一路由中存在多个重新验证时间时,更短的时间可能提高整个路由的重新验证频率,因此不要给每个请求随意设置互相冲突的策略。

注意运行模式与版本边界

revalidate 的路由段配置主要用于 Node.js 运行时下的传统缓存模型,开发模式也不会表现出完整的生产缓存语义。验证 ISR 时应使用 next build 与 next start,并以实际缓存命中、过期和更新结果为准。

重新验证最有价值的地方,是把“每次请求都最新”改成“在可接受的时间窗口内足够新”。只要这个窗口来自明确业务要求,就能用更少的服务器工作量换取稳定且可解释的页面性能。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置重新验证

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

登录哪都通