相同Gradle配置下本地构建成功但Docker环境构建失败是什么原因？

你遇到的错误本质是Kotlin编译守护进程被意外终止，导致Gradle通过RMI调用编译服务时连接中断，抛出EOF异常。即使本地和Gradle配置的内存参数一致，Docker环境下构建失败的常见原因如下：

1. Docker容器默认内存上限不足
   本地操作系统可分配内存通常远高于Docker默认分配的容器内存（多数Docker默认容器内存为2GB）。你配置的Gradle JVM最大堆内存为2GB，加上Kotlin编译守护进程、容器内系统进程的内存占用，总内存需求超过容器配额时，Docker会强制杀掉内存占用最高的进程（通常是Kotlin或Gradle守护进程），直接导致RMI调用中断。
2. gradle.properties配置未同步到Docker镜像
   如果你的Dockerfile中没有将项目根目录的gradle.properties拷贝到镜像构建工作目录，Gradle在容器内执行时不会读取到你配置的内存参数，会使用默认的小内存配置，直接触发OOM。
3. Kotlin编译守护进程内存未单独配置
   org.gradle.jvmargs只控制Gradle自身守护进程的内存，Kotlin编译器使用独立的守护进程，默认内存上限更低，大项目编译时很容易触发OOM终止。本地环境因为内存充足，Kotlin守护进程可以拿到足够的内存不会被终止，而Docker环境资源受限就会触发崩溃。

解决方案 #

• 调高Docker构建时的内存配额，执行构建命令时添加内存参数：docker build --memory=4g .，如果你使用Docker Desktop，可以在设置界面直接将默认容器内存调整到4GB以上。
• 确认Dockerfile中在执行构建前拷贝了gradle.properties文件：

# 先拷贝Gradle配置文件
COPY gradle.properties ./
COPY gradlew ./
COPY gradle ./
# 再执行构建
RUN gradlew build -Dspring.profiles.active=${PHASE}

• 在gradle.properties中添加Kotlin守护进程的内存配置：

kotlin.daemon.jvmargs=-Xmx2g -XX:MaxMetaspaceSize=1024m

• 针对Docker单次构建场景，可以直接禁用守护进程避免额外内存开销：

RUN gradlew build -Dspring.profiles.active=${PHASE} --no-daemon -Dkotlin.compiler.execution.strategy=in-process

内容的提问来源于stack exchange，提问作者henry-jo