staleTimes
experimental
了解如何覆盖客户端缓存的失效时间。
staleTimes 是一项实验性功能,可在客户端缓存(Client Cache)中缓存页面段。
你可以通过设置实验性的 staleTimes 标志来启用此实验性功能并提供自定义的重新验证时间:
next.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
experimental: {
staleTimes: {
dynamic: 30,
static: 180,
},
},
}
module.exports = nextConfigstatic 和 dynamic 属性对应基于不同类型链接预取的时间段(以秒为单位)。
- 当页面既不是静态生成的,也没有被完全预取时(例如使用
prefetch={true}),使用dynamic属性。- 默认值:0 秒(不缓存)
- 对于静态生成的页面,或当
Link上的prefetch属性设置为true时,或调用router.prefetch时,使用static属性。- 默认值:5 分钟
小知识:
- 加载边界(Loading boundaries)在此配置定义的
static期间被视为可重用。- 这不会影响局部渲染,意味着共享布局不会在每次导航时自动重新获取,只有发生变化的页面段才会。
- 这不会改变前进/后退缓存的行为,以防止布局偏移并防止丢失浏览器滚动位置。
版本历史#
| 版本 | 变更 |
|---|---|
v15.0.0 | dynamic staleTimes 的默认值从 30 秒更改为 0 秒。 |
v14.2.0 | 引入实验性的 staleTimes。 |