NNext.js 中文网 GitHub

cacheMaxMemorySize

配置 Next.js 在每个服务实例中保留的内存缓存大小。

cacheMaxMemorySize 以字节为单位设置每个 Next.js 服务实例保留的内存缓存大小。默认值为 50 MB。

next.config.ts
import type { NextConfig } from 'next'

const nextConfig: NextConfig = {
  cacheMaxMemorySize: 50 * 1024 * 1024, // 50 MB,默认值
}

export default nextConfig
next.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
  cacheMaxMemorySize: 50 * 1024 * 1024, // 50 MB,默认值
}

module.exports = nextConfig

该选项用于调整两个独立的缓存:

  • 服务端缓存,存储预渲染页面、Route Handler 响应和优化后的图片。当采用自定义 cacheHandler 时,将其设为 0,这样读取会转到你的存储,而不是每个实例的副本。
  • 'use cache' 背后的内置 handler。如果你通过 cacheHandlers 注册了自己的 handler,该 handler 会管理自己的内存,此选项将不再适用于它。

设置 cacheMaxMemorySize: 0 会禁用这两个内存缓存。这也是一种模拟 use cache 在 serverless 环境中行为的方式,在这种环境中缓存条目很少能在请求之间保留。

小知识:无论此选项如何设置,next dev 都会保留自己的内存缓存,以便快速重新加载。生产环境会严格遵循配置的值。