Gradle构建守护进程意外消失求助（本地正常CircleCi失败）

排查思路 #

• 检查CircleCI实例内存：本地能分配4G堆内存，但CircleCI默认实例内存可能不足（比如部分默认实例仅2G/3G），若配置的堆内存超过实例可用内存，守护进程会被系统OOM Killer强制杀掉。可在构建脚本中加入free -m命令输出当前实例的内存状态。
• 查看Gradle守护进程日志：在CircleCI构建日志中查找Gradle daemon的相关输出，或在构建命令中添加--info/--debug参数，获取更详细的报错信息，确认是否存在内存溢出或进程崩溃的具体原因。
• 核对Kotlin守护进程内存配置：当前配置中Kotlin daemon分配了2G堆内存，加上Gradle的4G堆内存，两者实际占用的内存（含元空间、栈内存等）可能超出实例总内存上限，导致进程被杀死。
• 确认Java环境一致性：检查CircleCI环境中的Java 17是否与本地使用的发行版（如OpenJDK、OracleJDK）一致，不同发行版可能存在兼容性问题引发进程崩溃。

解决办法 #

• 调整内存参数适配实例：降低Gradle和Kotlin守护进程的堆内存，例如将org.gradle.jvmargs修改为：

  org.gradle.jvmargs=-Xmx2G -Dkotlin.daemon.jvm.options=-Xmx1G -XX:+HeapDumpOnOutOfMemoryError -XX:+UseParallelGC -Dfile.encoding=UTF-8
  

  通常建议堆内存不超过实例总内存的70%，预留足够系统内存。
• 禁用Gradle守护进程：在构建命令中添加--no-daemon参数，直接运行构建而不使用守护进程，避免守护进程被杀死的问题，但会增加每次构建的启动时间。
• 更换GC参数：将当前的ParallelGC替换为G1GC，修改参数为-XX:+UseG1GC，G1GC在内存紧张场景下的稳定性更好，能降低内存溢出导致进程崩溃的概率。
• 升级CircleCI实例规格：若项目确实需要更大内存，在.circleci/config.yml中指定更高配置的实例，例如：

  machine:
    image: "ubuntu-2204:2023.10.1"
    resource_class: "medium"
  

  根据需求选择large或其他更高规格的resource_class。
• 清理构建缓存：CircleCI的缓存可能存在损坏，可在构建脚本中加入./gradlew clean，或配置CircleCI不缓存~/.gradle/caches目录，避免缓存问题引发的构建异常。

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