Docker多阶段构建Spring Boot镜像时Gradle构建过慢问题咨询

核心原因 #

• 无Gradle依赖缓存复用
  本地环境会将下载的依赖、构建缓存持久化存储在~/.gradle目录下，重复构建时无需重复下载依赖、执行已缓存的构建任务。而默认Docker构建过程是完全隔离的，每次执行builder阶段都会创建全新的空文件系统，所有依赖每次都要重新下载，构建任务也没有缓存可用，这是耗时翻倍的最主要原因。
• Docker资源分配不足
  Docker默认会限制容器可使用的CPU核心数、内存上限，通常远低于宿主机的硬件资源。Gradle构建属于高CPU、高内存消耗任务，资源受限会直接导致编译、测试、打包等环节执行速度大幅下降。
• 构建分层优化未生效
  你当前Dockerfile中RUN ${WORKSPACE}/gradlew build || return 0的写法无法正确完成依赖预下载：该命令执行失败后直接返回0跳过，大概率没有完成依赖拉取逻辑，相当于这一层完全没有起到预缓存依赖的作用，后续全量构建时依然要从头执行所有流程。
• Alpine镜像的性能损耗
  你使用的openjdk:8-jdk-alpine基于musl libc运行，而标准OpenJDK针对glibc做了大量性能优化，musl环境下Java应用的运行性能会有10%-30%的下降，也会拖慢Gradle的执行速度。
• 未开启Gradle构建优化参数
  本地环境通常会在全局gradle.properties中配置开启并行构建、构建缓存、守护进程等优化参数，而Docker容器内的环境默认没有这些配置，Gradle会以最基础的单线程模式运行。

优化方案 #

1. 持久化Gradle缓存，Docker构建时可以通过--mount=type=cache参数复用Gradle的依赖和构建缓存，修改builder阶段的RUN指令：

# 预下载依赖
RUN --mount=type=cache,target=/root/.gradle \
    ${WORKSPACE}/gradlew dependencies --no-daemon
# 执行构建
RUN --mount=type=cache,target=/root/.gradle \
    ${WORKSPACE}/gradlew :api:build -Dspring.profiles.active=${PHASE} --no-daemon --parallel --build-cache

2. 调整Docker资源配置，在Docker设置中将CPU核心数调整为宿主机的1/2以上，内存调整为8G以上，swap调整为2G以上。
3. 替换基础镜像为glibc版本的OpenJDK镜像，比如openjdk:8-jdk-slim，比alpine版本的构建性能更好。
4. 优化构建分层逻辑，只要构建脚本没有变更，依赖预下载层就可以复用，无需每次重新下载依赖。

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