AWS CodeBuild执行Angular 7项目ng build --prod时出现JavaScript堆内存不足问题的排查与解决求助

架构老林

2026-4-30

这个问题我之前帮别人排查过，咱们先搞清楚为什么CodeBuild会出这个问题，再一步步解决：

主要是资源配置和环境限制的差异：

CodeBuild默认使用的BUILD_GENERAL1_SMALL实例只有2GB内存，而你的本地开发机器大概率有8GB以上内存，Angular生产构建（加上AWS Amplify后打包逻辑更复杂）对内存需求很高，小规格实例直接扛不住。
CodeBuild是共享资源环境，CPU和内存会有调度限制，而本地机器是独占资源，内存分配更宽松。
另外CodeBuild的缓存可能积累了旧依赖或构建产物，额外占用内存，而本地你可能定期清理过node_modules或dist目录。

直接在CodeBuild项目的配置里，找到「环境」模块的实例类型，换成更大规格的：

比如BUILD_GENERAL1_MEDIUM（4GB内存）或BUILD_GENERAL1_LARGE（8GB内存），内存上来后，大部分内存溢出问题都能解决。

在你的buildspec.yml里修改构建命令，给Node.js分配更多内存，比如：

phases:
  build:
    commands:
      - NODE_OPTIONS="--max-old-space-size=6144" ng build --prod

这里的6144代表6GB内存，你可以根据实例规格调整：MEDIUM实例设为4096（4GB），LARGE实例设为6144或8192就行。

先确认angular.json里生产构建的aot和buildOptimizer都是true（Angular7的prod模式默认已开启，但建议检查一遍）：
```
"configurations": {
  "production": {
    "aot": true,
    "buildOptimizer": true
  }
}
```
按需导入Amplify模块：别直接import * as Amplify from 'aws-amplify'，而是只导入你需要的部分，比如import { Auth, Storage } from 'aws-amplify'，减少打包体积和内存占用。
用懒加载拆分模块：把大的业务模块拆成小模块，用Angular的懒加载特性，降低单次构建的内存压力。

在buildspec.yml的install阶段加个清理步骤，避免旧缓存拖后腿：

phases:
  install:
    commands:
      - rm -rf node_modules dist
      - npm install --no-cache

也可以暂时关闭CodeBuild的缓存功能，测试是不是缓存导致的问题。

如果用npm，也可以先全局设置内存上限，再执行构建：

npm config set max-old-space-size 6144
npm run build:prod

内容的提问来源于stack exchange，提问作者Abdul Moeez