Menu

cacheLife

cacheLife 选项允许你在组件或函数内使用 cacheLife 函数时，以及在 use cache 指令的作用域内定义自定义缓存配置文件。

用法

要定义一个配置文件，需启用 dynamicIO 标志并在 next.config.js 文件的 cacheLife 对象中添加缓存配置文件。例如，一个 blog 配置文件：

next.config.ts
TypeScript
import type { NextConfig } from 'next'
 
const nextConfig: NextConfig = {
  experimental: {
    dynamicIO: true,
    cacheLife: {
      blog: {
        stale: 3600, // 1小时
        revalidate: 900, // 15分钟
        expire: 86400, // 1天
      },
    },
  },
}
 
export default nextConfig

现在你可以在组件或函数中按如下方式使用这个自定义的 blog 配置：

app/actions.ts
TypeScript
import { unstable_cacheLife as cacheLife } from 'next/cache'
 
export async function getCachedData() {
  'use cache'
  cacheLife('blog')
  const data = await fetch('/api/data')
  return data
}

参考

配置对象具有以下格式的键值：

属性值描述要求
stalenumber客户端应缓存值而不检查服务器的持续时间。可选
revalidatenumber服务器上缓存应刷新的频率；重新验证时可能会提供过期值。可选
expirenumber值可以保持过期状态的最长持续时间，超过后切换为动态。可选 - 必须长于 revalidate