React / 系统课时
配置重新验证
配置重新验证
重新验证适合“内容需要更新,但没有必要每次请求都重新计算”的页面。你可以给缓存设置时间窗口,让大多数请求继续获得快速的静态响应,并在缓存变旧后由后续请求触发后台刷新,从而在性能和数据新鲜度之间取得平衡。
学习目标
- 理解时间重新验证与普通定时任务的区别
- 使用
revalidate为 App Router 页面设置刷新间隔 - 在生产模式下观察缓存从命中、过期到刷新后的变化
重新验证不是定时任务
时间重新验证中的数字表示缓存最多保持新鲜的时间窗口,而不是服务器每隔固定秒数主动运行一次任务。缓存过期后,通常要等下一次请求到来,Next.js 才会返回已有的旧结果并在后台生成新版本;新版本成功后,再替换旧缓存。

这类行为非常适合博客、商品目录、帮助中心或公开榜单:允许短时间看到旧内容,但希望避免每个请求都访问数据库或外部 API。若业务要求变更后立即可见,应使用按需重新验证;若要求每个请求都是最新值,则应改用动态渲染。
给页面配置重新验证时间
以下示例适用于 App Router 且没有启用 cacheComponents: true 的缓存模型。export const revalidate = 60 表示该路由的默认重新验证周期为 60 秒,而且这个值必须能被静态分析,因此直接写数字最稳妥。
片段示例放在现有项目的 app/blog/page.tsx,数据来自可直接访问的公开 API。
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>
)
}预期结果
首次请求:生成并缓存 /blog
60 秒内:后续请求复用缓存
超过 60 秒后的首个请求:可先返回旧缓存,并触发后台重新生成
重新生成成功后:后续请求获得新缓存这里的 60 秒不是“保证第 60 秒自动刷新”。如果页面在过期后一直无人访问,就不会因为时间到了而凭空产生一次请求。
用生产模式观察缓存
开发模式中的页面通常按请求执行,无法准确模拟生产缓存。先构建并启动生产服务器,再请求页面并检查响应头。
npm run build
npm start预期输出
▲ Next.js <VERSION>
- Local: http://localhost:<PORT>
✓ Ready in <TIME>另开终端发送真实 GET 请求并只保留响应头:
curl -s -D - http://localhost:<PORT>/blog -o /dev/null预期输出
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,并以实际缓存命中、过期和更新结果为准。
重新验证最有价值的地方,是把“每次请求都最新”改成“在可接受的时间窗口内足够新”。只要这个窗口来自明确业务要求,就能用更少的服务器工作量换取稳定且可解释的页面性能。