NNext.js 中文网 GitHub

staleTimes

experimental

了解如何覆盖客户端缓存的失效时间。

staleTimes 是一项实验性功能,可在客户端缓存(Client Cache)中缓存页面段。

你可以通过设置实验性的 staleTimes 标志来启用此实验性功能并提供自定义的重新验证时间:

next.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
  experimental: {
    staleTimes: {
      dynamic: 30,
      static: 180,
    },
  },
}

module.exports = nextConfig

static 和 dynamic 属性对应基于不同类型链接预取的时间段(以秒为单位)。

  • 当页面既不是静态生成的,也没有被完全预取时(例如使用 prefetch={true}),使用 dynamic 属性。
    • 默认值:0 秒(不缓存)
  • 对于静态生成的页面,或当 Link 上的 prefetch 属性设置为 true 时,或调用 router.prefetch时,使用 static 属性。
    • 默认值:5 分钟

小知识:

版本历史#

版本变更
v15.0.0dynamic staleTimes 的默认值从 30 秒更改为 0 秒。
v14.2.0引入实验性的 staleTimes。
Next.js 中文网