Angular项目AOT构建时JavaScript堆内存溢出问题求助

问题背景 #

在1vCPU、1GB内存的机器上构建Angular应用，初期构建正常，但项目规模扩大后，开启AOT预编译时出现JavaScript heap out of memory错误。曾修改package.json的build脚本为：

node --max_old_space_size=8192 node_modules/@angular/cli/bin/ng build --configuration=prod

当时能正常运行，但后续再次失败，报错信息如下：

FATAL ERROR: Ineffective mark-compacts near heap limit Allocation failed - JavaScript heap out of memory
 1: 0xa1a640 node::Abort() [ng build --prod]
 2: 0xa1aa4c node::OnFatalError(char const*, char const*) [ng build --prod]
 3: 0xb9a62e v8::Utils::ReportOOMFailure(v8::internal::Isolate*, char const*, bool) [ng build --prod]
 4: 0xb9a9a9 v8::internal::V8::FatalProcessOutOfMemory(v8::internal::Isolate*, char const*, bool) [ng build --prod]
 5: 0xd57c25  [ng build --prod]
 6: 0xd582b6 v8::internal::Heap::RecomputeLimits(v8::internal::GarbageCollector) [ng build --prod]
 7: 0xd64b75 v8::internal::Heap::PerformGarbageCollection(v8::internal::GarbageCollector, v8::GCCallbackFlags) [ng build --prod]
 8: 0xd65a25 v8::internal::Heap::CollectGarbage(v8::internal::AllocationSpace, v8::internal::GarbageCollectionReason, v8::GCCallbackFlags) [ng build --prod]
 9: 0xd684dc v8::internal::Heap::AllocateRawWithRetryOrFail(int, v8::internal::AllocationType, v8::internal::AllocationOrigin, v8::internal::AllocationAlignment) [ng build --prod]
10: 0xd2eefb v8::internal::Factory::NewFillerObject(int, bool, v8::internal::AllocationType, v8::internal::AllocationOrigin) [ng build --prod]
11: 0x10714ce v8::internal::Runtime_AllocateInYoungGeneration(int, unsigned long*, v8::internal::Isolate*) [ng build --prod]
12: 0x140dc19  [ng build --prod]
Aborted (core dumped)

使用ng build --aot=false可正常构建，但希望保留AOT预编译特性，寻求永久解决办法。

环境信息：

• Angular/cli: 11.2.14
• Typescript: 4.1.6
• angular.json中build配置默认开启AOT，生产环境开启optimization等优化

解决方案 #

1. 调整Node.js内存参数至合理范围 #

之前设置的--max_old_space_size=8192远超机器物理内存，会触发大量磁盘swap，反而拖慢构建导致失败。建议设置为接近物理内存的合理值，比如768MB：

• 修改package.json的build脚本：

  "scripts": {
    "build:prod": "node --max_old_space_size=768 node_modules/@angular/cli/bin/ng build --configuration=prod"
  }
  

• 或者通过环境变量全局配置（更简洁）：
  Linux/macOS：

  "scripts": {
    "build:prod": "export NODE_OPTIONS=\"--max_old_space_size=768\" && ng build --configuration=prod"
  }
  

  Windows：

  "scripts": {
    "build:prod": "set NODE_OPTIONS=--max_old_space_size=768 && ng build --configuration=prod"
  }
  

2. 优化Angular构建配置 #

• 启用增量构建：在angular.json的projects.[your-project].architect.build.configurations.prod中添加：

  "incremental": true,
  "tsConfig": "tsconfig.app.json"
  

  增量构建只会重新编译修改过的文件，大幅降低内存占用。
• 调整优化选项：暂时关闭部分高内存消耗的优化项，比如关键CSS内联：

  "optimization": {
    "scripts": true,
    "styles": {
      "minify": true,
      "inlineCritical": false
    },
    "fonts": true
  }
  

• 缩小编译范围：
  • 检查angular.json的assets、styles配置，移除不需要打包的文件；
  • 在tsconfig.json中通过exclude字段排除测试文件、第三方无关代码：

    "exclude": ["node_modules", "src/test.ts", "src/**/*.spec.ts"]
    

• 禁用并行构建：1vCPU机器多进程会抢占资源，在angular.json的build配置中添加：

  "parallel": false
  

3. 升级依赖版本 #

当前Angular CLI 11.x版本较旧，后续版本（如12.x、13.x）对AOT构建的内存管理有不少优化。可以升级到同大版本的最新补丁（11.2.14已是11.x最终版，建议升级到12.x稳定版），同时同步升级TypeScript到对应兼容版本，提升编译效率。

4. 系统层面补充内存 #

• 临时增加swap分区：若机器权限允许，创建1GB临时swap文件缓解内存压力：

  sudo fallocate -l 1G /swapfile
  sudo chmod 600 /swapfile
  sudo mkswap /swapfile
  sudo swapon /swapfile
  

  构建完成后可关闭swap：sudo swapoff /swapfile
• 清理系统进程：构建前关闭机器上不必要的后台进程，释放物理内存。

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