Docker构建Gradle项目依赖重复下载问题及缓存优化需求

原Dockerfile的核心问题 #

• 先复制源码再执行构建，导致依赖缓存失效：只要源码有变动，就会重新下载所有Gradle依赖
• 重复执行两次clean && build操作，冗余耗时
• Jar文件名硬编码，缺乏灵活性

优化后的Dockerfile #

ARG SERVICE_NAME=users-service
FROM openjdk:21-ea-slim AS builder

ARG SERVICE_NAME
WORKDIR /app/${SERVICE_NAME}

# 第一步：复制Gradle依赖配置相关文件，缓存依赖层
COPY ./${SERVICE_NAME}/gradlew .
COPY ./${SERVICE_NAME}/gradle ./gradle
COPY ./build.gradle.kts /app/build.gradle.kts
COPY ./${SERVICE_NAME}/build.gradle.kts .

# 预下载所有Gradle依赖，仅当配置文件修改时重新执行
RUN chmod +x ./gradlew && ./gradlew build -x test --parallel --daemon

# 第二步：复制项目源码，仅当源码修改时重新构建
COPY ./${SERVICE_NAME}/src ./src

# 执行最终构建（跳过测试）
RUN ./gradlew build -x test --parallel

# 运行阶段：构建轻量运行镜像
FROM openjdk:21-ea-slim

ARG SERVICE_NAME
WORKDIR /app

RUN mkdir logs

# 从构建阶段复制编译好的Jar包，使用变量避免硬编码
COPY --from=builder /app/${SERVICE_NAME}/build/libs/${SERVICE_NAME}-0.1.0-alpha-1.jar ./app.jar

ENV PORT=8001
EXPOSE $PORT

ENTRYPOINT ["java", "-jar", "app.jar"]

关键优化点说明 #

• 依赖缓存分层：先复制Gradle wrapper、项目构建配置文件，单独执行依赖预下载步骤。Docker会缓存这一层，只有当build.gradle.kts或Gradle版本配置变化时，才会重新下载依赖，彻底解决重复下载问题。
• 减少冗余操作：移除原Dockerfile中重复的clean && build步骤，仅在复制源码后执行一次构建，节省时间。
• 灵活的Jar包引用：使用${SERVICE_NAME}变量替代硬编码的Jar文件名，适配多服务场景。
• 多阶段构建瘦身：构建阶段使用完整JDK，运行阶段仅保留基础JDK镜像，减小最终镜像体积。
• 强制跳过测试：全程使用-x test参数确保测试环节被跳过，符合需求。

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