staleTimes

staleTimes 是一个实验性功能，可以在 客户端路由缓存 中缓存页面段。

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

next.config.js

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

module.exports = nextConfig

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

• dynamic 属性用于页面既不是静态生成也不是完全预取的情况（例如，使用 prefetch={true}）。
  • 默认值：0 秒（不缓存）
• static 属性用于静态生成的页面，或者当 Link 上的 prefetch 属性设置为 true 时，或者当调用 router.prefetch 时。
  • 默认值：5 分钟

提示：

• 加载边界 在此配置中定义的 static 期间被认为是可重用的。
• 这不会影响 部分渲染，意味着共享布局不会在每次导航时自动重新获取，只会重新获取发生变化的页面段。
• 这不会改变 前进/后退缓存 行为，以防止布局偏移并防止丢失浏览器滚动位置。

你可以在这里了解更多关于客户端路由缓存的信息。

版本历史

版本	更改
v15.0.0	dynamic staleTimes 默认值从 30 秒更改为 0 秒。
v14.2.0	引入实验性 staleTimes。