直接调大gradle进程堆内存上限是最有效的防oom手段，需在gradle.properties中配置org.gradle.jvmargs=-xmx6144m -xx:maxmetaspacesize=1024m等参数，并配合守护进程、并行构建和构建缓存优化。
直接调大 Gradle 进程的堆内存上限，是最有效、最常用的防止构建时 OutOfMemoryError: Java heap space 的手段。关键不是盲目加到最大，而是结合项目规模、机器资源和常见瓶颈点合理配置。
核心配置位置：gradle.properties 文件
Gradle 会按顺序读取多个 gradle.properties，优先级从高到低为：
- 项目根目录下的
gradle.properties（推荐，作用于当前项目） -
GRADLE_USER_HOME目录下的全局配置（如~/.gradle/gradle.properties，影响所有项目） -
gradle/wrapper/gradle-wrapper.properties（部分旧版本支持，不推荐主用）
在对应文件中添加或修改这一行：
org.gradle.jvmargs=-Xmx6144M -XX:MaxMetaspaceSize=1024M -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8关键参数说明与建议值
-Xmx 是核心：它设定了 Gradle 守护进程（Daemon）JVM 的最大堆内存。
- 中小型项目（模块
- 大型 Android 或多模块 Java 项目（模块 30+ 或含大量注解处理器）：建议 -Xmx6144M～8192M（6～8GB）
- 不建议超过物理内存的 70%，避免系统交换（swap）拖慢整体构建
-XX:MaxMetaspaceSize 防止元空间溢出：现代项目依赖多、类加载频繁，尤其 Kotlin/Annotation Processing 场景下容易触发 Metaspace OOM。设为 512M～1024M 较稳妥。
-XX:+HeapDumpOnOutOfMemoryError 必开：一旦真发生 OOM，自动保存堆快照（.hprof），后续可用 VisualVM 或 MAT 分析根本原因（比如是依赖解析卡住，还是 Kotlin 编译器吃内存）。
配套优化项不能少
单调堆内存只是基础，需配合其他设置才能真正稳住大项目构建：
-
启用守护进程：确保
org.gradle.daemon=true（默认已开启，但建议显式确认） -
开启并行构建：多模块项目加
org.gradle.parallel=true，减少串行等待 -
启用构建缓存：加
org.gradle.caching=true，复用历史任务输出，大幅降低重复编译压力 -
Kotlin 用户额外注意：如果用 Kotlin，建议同步加大其 daemon 内存：
org.gradle.jvmargs=-Xmx6144M -Dkotlin.daemon.jvm.options="-Xmx4096M"
验证是否生效
改完配置后，执行一次构建，并观察日志开头的 JVM 参数：
Starting Gradle Daemon with JVM arguments [-Xmx6144M ...]若显示的数值是你刚设置的值，说明配置已加载成功。后续再遇到 OOM，就可以结合生成的 heap dump 进行深度排查，而不是反复试错调参。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
