Gradle升级后Java堆内存不足错误的排查与解决

问题复现 #

升级过程中尚未引入所有子项目时，出现堆内存溢出错误：

* What went wrong:
Out of memory. Java heap space

Possible solution:
 - Check the JVM memory arguments defined for the gradle process in:
   gradle.properties in project root directory

已设置org.gradle.jvmargs=-Xmx4g，不考虑继续增大堆内存，同时观察到并行运行的任务数量较之前增多。

排查方向 #

1. Gradle版本差异的影响 #

• Gradle 7.x默认开启并行构建（含配置阶段并行），而5.x仅默认开启执行阶段并行，更多并发线程会直接提升内存占用。
• 新版本Gradle的插件兼容性问题：旧版第三方插件在7.x环境下可能存在内存泄漏或低效内存使用的情况。

2. IDE环境差异（IntelliJ vs Eclipse） #

• IntelliJ的Gradle集成默认可能开启自动项目同步、委托IDE构建至Gradle等特性，这些后台操作会额外消耗内存。
• IntelliJ对Gradle进程的管理逻辑与Eclipse不同，可能导致Gradle进程持续占用内存未释放。

3. 项目Gradle结构变更问题 #

• 误修改settings.gradle引入了不必要的子项目、重复配置，或存在循环依赖导致Gradle反复解析项目结构。
• 根项目build.gradle的全局配置冗余，比如给所有子项目应用了非必要插件，每个插件加载都会占用额外内存。

优化解决方法 #

1. 限制并行任务数量 #

• 在gradle.properties中显式设置最大工作线程数，避免并发过载：

  org.gradle.workers.max=2  # 根据CPU核心数调整，建议设为核心数的1/2到2/3
  

• 临时关闭并行构建（用于排查是否由并行导致）：

  org.gradle.parallel=false
  

2. 启用配置缓存 #

配置缓存能缓存项目配置结果，避免重复解析带来的内存消耗，在gradle.properties中开启：

org.gradle.configuration-cache=true

注意：需确保项目中使用的插件兼容Gradle 7.5.1的配置缓存（官方插件基本都支持，第三方插件可查看其文档确认）。

3. 定位内存消耗热点 #

• 使用Gradle性能分析命令生成报告，查看配置阶段或任务执行阶段的内存占用细节：

  ./gradlew build --profile
  

  报告生成在build/reports/profile目录下，重点关注「Memory Usage」和「Configuration」板块，定位消耗内存最多的环节。
• 暂时禁用非必要插件，逐一排查是否存在插件内存泄漏问题。

4. 调整IntelliJ Gradle相关设置 #

• 关闭「Automatically import changes」，手动触发项目同步，避免频繁触发配置解析。
• 关闭「Delegate IDE build/run actions to Gradle」，改用IntelliJ内置构建系统（项目结构支持的前提下），减少Gradle进程的持续内存占用。
• 在IntelliJ的「Settings > Build, Execution, Deployment > Build Tools > Gradle」中，单独调整Gradle VM参数，确保与gradle.properties的设置一致，避免重复配置导致的内存浪费。

5. 分批引入子项目 #

逐步添加子项目，每添加一个就执行一次构建，定位到哪个子项目触发了内存暴增，针对性优化该子项目的依赖、插件或配置。

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