serverComponentsHmrCache
experimental
配置 Server Components 中的 fetch 响应是否跨 HMR 刷新请求进行缓存。
实验性的 serverComponentsHmrCache 选项允许你在本地开发中跨热模块替换(Hot Module Replacement,HMR)刷新缓存 Server Components 中的 fetch 响应。这可以加快响应速度,并降低计费 API 调用的成本。
默认情况下,HMR 缓存适用于所有 fetch 请求,包括那些带有 cache: 'no-store' 选项的请求。这意味着未缓存的请求在两次 HMR 刷新之间不会显示新数据。不过,缓存会在导航或整页重新加载时清除。
你可以在 next.config.js 文件中将 serverComponentsHmrCache 设置为 false 来禁用 HMR 缓存:
next.config.ts
import type { NextConfig } from 'next'
const nextConfig: NextConfig = {
experimental: {
serverComponentsHmrCache: false, // 默认为 true
},
}
export default nextConfignext.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
experimental: {
serverComponentsHmrCache: false, // 默认为 true
},
}
module.exports = nextConfig小知识: 为了获得更好的可观测性,我们建议使用
logging.fetches选项,它会在开发期间在控制台中记录 fetch 缓存命中和未命中的情况。