Next.js运行报FATAL ERROR: Ineffective mark-compacts near heap limit错误如何解决

你遇到的是Node.js运行时堆内存不足导致的崩溃，触发原因是Next.js开发或编译阶段占用的内存超出了Node.js默认分配的上限（默认值通常为2GB左右），对应报错截图如下：

修复方案 #

1. 临时提升Node.js堆内存上限（最快生效） #

修改项目package.json中的脚本命令，给Node进程指定更大的堆内存上限：

{
  "scripts": {
    // --max-old-space-size后面的数值为内存大小，单位MB，8192即8GB，可根据自己设备的内存配置调整
    "dev": "node --max-old-space-size=8192 node_modules/next/dist/bin/next dev",
    "build": "node --max-old-space-size=8192 node_modules/next/dist/bin/next build",
    "start": "node --max-old-space-size=8192 node_modules/next/dist/bin/next start"
  }
}

如果是Windows设备命令不生效，可以改成：
"dev": "set NODE_OPTIONS=--max-old-space-size=8192 && next dev"

2. 排查内存占用过高的根因 #

只扩容内存是治标不治本的方案，建议同步排查项目中占用内存过高的原因：

• 检查是否导入了大量未压缩的静态资源，比如体积超过2MB的图片、未转码的视频，可将图片转换成WebP格式压缩后再导入
• 检查getStaticProps/getServerSideProps/路由处理函数等服务端运行逻辑中是否存在内存泄漏，比如未关闭的数据库连接、大量循环创建未销毁的对象
• 清理项目中未使用的npm依赖，减少编译阶段需要加载的包体积
• 如果使用的是Next.js 13+ App Router，检查是否引入了未做兼容处理的第三方依赖，触发重复编译占用内存

3. 长期优化方案 #

• 升级Node.js到最新LTS版本，高版本Node.js的内存管理效率更高，不少老版本存在的内存泄漏问题已经被官方修复
• 升级Next.js到最新稳定版，官方会持续修复编译阶段的内存泄漏问题
• 开发阶段可以在next.config.js中添加按需编译配置，减少缓存的页面数量，降低内存占用：

/** @type {import('next').NextConfig} */
const nextConfig = {
  onDemandEntries: {
    // 页面闲置多久后被移除缓存，单位ms，这里设15秒
    maxInactiveAge: 15 * 1000,
    // 同时保留在缓存中的页面数量
    pagesBufferLength: 2,
  }
}

module.exports = nextConfig

内容的提问来源于stack exchange，提问作者Abdur Rahman