Ionic3执行ionic cordova build android --prod出现JavaScript堆内存溢出

算力阿峰

2026-10-5

问题原因

版本不兼容：Ionic 3 配套的官方推荐 Node 版本范围为 8.x ~ 10.x LTS，你使用的 Node 13.12.0 属于非 LTS 过渡版本，其 V8 引擎的内存分配规则与项目中使用的旧版 @ionic/app-scripts@3.2.1 构建工具不兼容，生产构建需要执行的 AOT 编译、代码压缩、Tree Shaking 等操作本身内存占用高，版本不匹配会加剧内存泄漏问题，直接触发堆内存上限。
依赖体积过大冗余：项目依赖列表包含 DevExtreme、PrimeNG、Firebase、Globalize 等多个大体积第三方库，同时存在功能重复的冗余依赖：如同时安装了 ionic-select-searchable 和 ionic-selectable 两个选择框组件、@ionic-native/transfer 和 @ionic-native/file-transfer 两个文件传输依赖，全部纳入编译流程会大幅提升内存占用。
默认堆内存上限不足：旧版 Node 默认的堆内存上限仅为 1.4GB 左右，生产构建的全量优化操作很容易触顶。
构建工具已知缺陷：@ionic/app-scripts@3.2.1 存在官方确认的内存泄漏问题，编译大量第三方依赖时不会及时释放无用内存，进一步提升了内存溢出的概率。

解决方案

调大 Node 堆内存上限：修改 package.json 中的 scripts 配置，在构建命令前添加内存参数，示例配置如下：

"scripts": {
  "clean": "ionic-app-scripts clean",
  "build": "node --max-old-space-size=8192 ./node_modules/@ionic/app-scripts/bin/ionic-app-scripts.js build",
  "lint": "ionic-app-scripts lint",
  "ionic:build": "node --max-old-space-size=8192 ./node_modules/@ionic/app-scripts/bin/ionic-app-scripts.js build",
  "ionic:serve": "ionic-app-scripts serve"
}

其中 8192 代表分配 8GB 堆内存，可根据你的设备内存情况调整为 4096（4GB）等数值。

降级 Node 版本：将 Node 版本降级到 10.x LTS 系列（如 10.24.1），该版本是 Ionic 3 官方适配的最高稳定 LTS 版本，可解决绝大多数版本不兼容导致的内存问题。
清理冗余依赖：删除功能重复、未实际使用的依赖，减少编译环节需要处理的代码体积。
升级构建工具：将 @ionic/app-scripts 升级到 3.2.4 版本，这是 Ionic 3 配套的最终稳定版构建工具，已修复内存泄漏相关缺陷，执行命令 npm i @ionic/app-scripts@3.2.4 --save-dev 即可升级。
构建前清理缓存：每次执行生产构建前先运行 npm run clean 清除历史构建缓存，避免额外内存占用。

内容的提问来源于stack exchange，提问作者K. Ajay