React部署AWS Amplify时遭遇JavaScript堆内存溢出问题求助

1. 修正构建脚本的参数传递方式 #

你之前的脚本写法错误，--max_old_space_size是Node.js的启动参数，而非react-scripts的参数，直接加在react-scripts build后不会被识别。需要直接调用Node命令执行build脚本：

"scripts": {
  ...
  "build": "node --max_old_space_size=16384 node_modules/react-scripts/scripts/build.js",
  ...
}

提交修改后重新触发Amplify构建，确保参数正确传递给Node进程。

2. 通过Amplify环境变量全局配置Node内存 #

这是更可靠的方式，直接在Amplify控制台设置全局Node选项：

• 打开AWS Amplify控制台，进入你的应用
• 切换到「构建设置」页面
• 在「环境变量」区域点击「编辑」，添加：
  • 键：NODE_OPTIONS
  • 值：--max_old_space_size=16384
• 保存后重新启动构建流程，Node会自动加载该内存配置。

3. 优化应用构建体积降低内存消耗 #

如果单纯加内存仍无法解决，说明应用构建时的资源占用过高，可从以下方向优化：

• 清理冗余依赖：用yarn why或npm ls分析依赖树，移除未使用的包
• 启用代码分割：用React的React.lazy和Suspense拆分大型组件，减少单批次构建的代码量
• 优化静态资源：将大体积图片、视频上传至S3，通过CDN引用，避免打包进应用
• 简化Webpack配置（若使用craco或已eject）：移除不必要的插件，启用更高效的压缩策略

4. 升级构建环境的Node.js版本 #

旧版Node.js的内存管理效率较低，Amplify支持指定Node版本：

• 在项目根目录创建.nvmrc文件，写入18或20（推荐LTS版本）
• 或在Amplify的构建规范（amplify.yml）中添加版本切换命令：

preBuild:
  commands:
    - nvm install 18
    - nvm use 18

内容的提问来源于stack exchange，提问作者Muhammed Didin