使用craco部署项目出现JavaScript堆内存溢出错误的原因是什么？

问题结论 #

craco 本身是对 react-scripts 的封装层，运行时需要额外加载配置解析、自定义插件/规则的处理逻辑，同等项目下内存占用确实比原生 react-scripts 高10%-30%。如果你的部署环境原有的 Node 内存配额刚好满足 react-scripts 的构建需求，切换为 craco 后就很容易触发内存溢出报错。

可行解决方法 #

• 调整 Node 堆内存上限，修改 package.json 中的构建指令，手动指定内存配额：
  把原有的 build 指令修改为：

  "build": "node --max_old_space_size=4096 node_modules/@craco/craco/bin/craco.js build"
  

  其中 4096 代表分配4G内存，你可以根据部署环境的可用内存调整为2048（2G）、8192（8G）等数值。
• 优化 craco 配置：检查 craco.config.js 中是否开启了不必要的插件、生产环境是否开启了不需要的 sourcemap、antd 主题自定义是否存在重复引入样式的逻辑，减少不必要的内存消耗。
• 调整 Gitlab CI 配置：如果是在 Gitlab runner 中触发的构建，可以适当调高构建任务的内存配额，避免和其他并行任务抢占内存。

验证方法 #

你可以在本地执行 craco 构建命令，通过任务管理器/活动监视器查看 Node 进程的峰值内存占用，确认内存上限调整的数值是否足够。

内容的提问来源于stack exchange，提问作者Athavan T