CI流水线Flutter安卓构建失败提示Gradle守护进程意外消失

核心错误表现 #

Gradle构建守护进程意外终止，你尝试的调整堆内存、关闭守护进程、修改编码参数未生效，大概率是以下原因导致：

• CI运行器可用内存不足：你给Gradle配置了4G堆内存，但CI节点本身的可用内存加上其他构建进程（如Dart编译、资源压缩进程）的内存占用超过系统上限，被Linux OOM killer直接杀死进程
• Java版本与构建组件不兼容：日志显示你用的Gradle 6.7.1运行在OpenJDK 11环境下，部分版本的Android Gradle插件（AGP）和JDK 11存在兼容性bug，会触发无日志的进程崩溃
• 容器资源限制：如果用的是容器化CI执行器（Docker/K8s），容器预设的内存/CPU上限被触发后，容器被强制销毁，内部的Gradle进程直接消失
• 构建缓存损坏：CI复用的Gradle缓存目录存在损坏文件，触发进程异常退出
• 版本不匹配：Gradle 6.7.1和项目使用的AGP版本、Flutter版本不兼容，引发native层崩溃，日志来不及输出就退出

优先排查内存问题 #

• 查看CI节点的系统日志，执行dmesg | grep -i 'kill\|oom'，确认是否有OOM killer杀死Gradle进程的记录
• 若确认是内存不足，优先将CI节点可用内存扩容到8G以上，若无法扩容则降低Gradle堆内存配置，添加到gradle.properties：

org.gradle.jvmargs=-Xmx2048M -XX:MaxMetaspaceSize=512m
org.gradle.workers.max=2
org.gradle.parallel=true

排查兼容性问题 #

• 确认android/build.gradle中AGP版本和Gradle 6.7.1匹配：Gradle 6.7.1对应支持的AGP版本为4.2.x，版本不匹配请调整到对应范围
• 确认当前Flutter版本官方推荐的Gradle/AGP版本，不要私自调整Gradle版本

清理缓存验证 #

• 临时关闭CI的Gradle缓存复用，执行构建命令时添加--clean --no-build-cache参数走全量编译，若构建成功则删除旧的CI缓存，后续重新生成缓存即可

开启全量日志定位问题 #

• 构建命令添加--stacktrace --debug参数，输出全量构建日志，下次崩溃时可拿到进程退出前的具体错误栈，定位具体崩溃点

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