自定义 Next.js 缓存处理器 | Next.js

在 Next.js 中，默认缓存处理器用于 Pages 和 App Router，使用文件系统缓存。这无需任何配置，但您可以通过在 next.config.js 中使用 cacheHandler 字段来自定义缓存处理器。

next.config.js

module.exports = {
  cacheHandler: require.resolve('./cache-handler.js'),
  cacheMaxMemorySize: 0, // 禁用默认的内存缓存
}

查看自定义缓存处理器的示例并了解更多实现细节。

API 参考

缓存处理器可以实现以下方法：get、set 和 revalidateTag。

`get()`

参数	类型	描述
`key`	`string`	缓存值的键。

返回缓存的值，如果未找到则返回 null。

`set()`

返回 Promise<void>。

`revalidateTag()`

参数	类型	描述
`tag`	`string`	要重新验证的缓存标签。

返回 Promise<void>。了解更多关于重新验证数据或 revalidateTag() 函数的信息。

须知：

revalidatePath 是缓存标签之上的便利层。调用 revalidatePath 会调用您的 revalidateTag 函数，然后您可以选择是否根据路径标记缓存键。

版本历史

版本	变更
`v14.1.0`	重命名为 `cacheHandler` 并稳定化。
`v13.4.0`	`incrementalCacheHandlerPath` (实验性) 支持 `revalidateTag`。
`v13.4.0`	`incrementalCacheHandlerPath` (实验性) 支持独立输出。
`v12.2.0`	添加 `incrementalCacheHandlerPath` (实验性)。

自定义 Next.js 缓存处理器

API 参考