StaleTimes (实验性功能)

警告：staleTimes 配置是实验性功能。此配置策略未来可能会变更。

staleTimes 是一项实验性功能，允许配置客户端路由缓存的失效周期。

该配置选项自 v14.2.0-canary.53 版本起可用。

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

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

module.exports = nextConfig

static 和 dynamic 属性分别对应基于不同类型链接预取 (link prefetching) 的时间周期（以秒为单位）。

• dynamic 属性用于页面既非静态生成也未完全预取的情况（即 prefetch= 未设置时）
  • 默认值：0 秒（不缓存）
• static 属性用于静态生成的页面，或当 Link 的 prefetch 属性设为 true 时，亦或调用 router.prefetch 时
  • 默认值：5 分钟

须知：

• 加载边界 (Loading boundaries) 在此配置的 static 周期内被视为可复用
• 此配置不会影响部分渲染 (partial rendering)，即共享布局不会在每次导航时自动重新获取，仅会更新发生变更的页面片段
• 此配置不会改变前进/后退缓存 (back/forward caching) 行为，以防止布局偏移并保持浏览器滚动位置

您可以在此处了解更多关于客户端路由缓存的信息。

版本历史