Gradle守护进程内存不足需调大org.gradle.jvmargs，推荐设为-Xmx4096m -Xms2048m -XX:MaxMetaspaceSize=1g，并重启终端或IDE以生效；Kotlin编译器若fork子进程，还需单独配置其堆内存。
Gradle守护进程内存不够，org.gradle.jvmargs 必须调大
Kotlin编译本身不直接申请堆内存，但它跑在 Gradle 守护进程的 JVM 里。默认的 -Xmx512m 在中大型项目里撑不住，尤其开了 kotlin.incremental=true 后，AST 缓存、类路径快照都会吃内存。一旦触发 GC 频繁或 OOM，就会卡在 :app:compileDebugKotlin 任务不动。
实操建议：
- 在项目根目录
gradle.properties中添加（不要用build.gradle）：org.gradle.jvmargs=-Xmx4096m -Xms2048m -XX:MaxMetaspaceSize=1g -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8 -
-Xms2048m很关键：避免编译中途因堆扩容导致 STW 停顿； - 别盲目设成
-Xmx8192m：如果物理内存 ≤16GB，可能挤占系统缓存，反而让 AAPT2 或链接器抢不到页帧，整机卡死； - 改完必须重启终端或 IDE，否则旧 daemon 还在用老参数。
Kotlin 编译器独立内存没配，kotlin.compiler.execution.strategy 要设对
Gradle 7.0+ 默认用 in-process 模式跑 Kotlin 编译器，意味着它和 Gradle 主进程共享同一 JVM 堆。但某些场景（比如用了大量 annotation processor）会触发 Kotlin 编译器 fork 子进程，这时它默认只分到 512MB，很容易在 kaptGenerateStubs 或 compileKotlin 阶段报 Java heap space。
实操建议：
- 在
gradle.properties加上：kotlin.compiler.execution.strategy=in-process（强制不 fork）； - 如果必须 fork（如某些 kapt 插件要求），则需额外控制子进程内存：
在build.gradle.kts的kotlin块里加：compilerOptions { jvmTarget.set(JvmTarget.JVM_17); freeCompilerArgs.add("-Xmx3g") }； - 注意
-Xmx3g是传给 Kotlin 编译器子进程的，不是 Gradle 守护进程——两者参数不互通。
Android 项目 Dex 阶段爆内存，javaMaxHeapSize 和 R8 分开调
Kotlin 编译完只是第一步。后续 transformClassesWithDexBuilder 或 R8 优化阶段，会把所有 .class 合并成 dex，这个过程由独立的 JVM 执行，内存不受 org.gradle.jvmargs 管控。常见报错是 UNEXPECTED TOP-LEVEL ERROR 或 GC overhead limit exceeded，根源其实是 D8/R8 进程堆溢出。
实操建议：
- 在
app/build.gradle的android { }块内加：dexOptions { javaMaxHeapSize = "4g" }（AGP - AGP 7.0+ 已废弃
dexOptions，改用：android { compileOptions { sourceCompatibility = JavaVersion.VERSION_17; targetCompatibility = JavaVersion.VERSION_17 } }，再配合 R8 单独配置； - R8 内存需在
gradle.properties加：android.useAndroidX=true+android.enableJetifier=false（减少中间转换开销），并在proguard-rules.pro里禁用无用的 shrink 规则。
并行编译开太多，org.gradle.parallel 和 CPU 核心数要匹配
很多人以为开 org.gradle.parallel=true 就一定快，但 Kotlin 编译是内存密集型任务。4 核 CPU 开 8 个并发 Kotlin 编译任务，每个分到 1GB 堆，结果所有任务都在等 GC，总耗时反而翻倍。
实操建议：
- 先查 CPU 核心数：
nproc（Linux/macOS）或Get-CimInstance Win32_Processor | Select-Object NumberOfCores（Windows）； - 设
org.gradle.parallel=true后，再限制最大并发数：org.gradle.configuration-cache=true（AGP 8.0+ 推荐） +org.gradle.parallel.max-workers=3（4 核机器建议设为 n-1）； - 增量编译时，
kotlin.incremental=true比并行更有效——它只重编改动文件的 AST，而不是起一堆新 JVM。
最易被忽略的一点：Kotlin 编译内存问题往往不是单点参数能解决的。Gradle 守护进程、Kotlin 编译器子进程、D8/R8 工具进程、kapt 进程——这四个 JVM 实例各自有独立内存边界，漏调任何一个，都可能在不同构建阶段突然崩掉。别只盯着 org.gradle.jvmargs。
