多阶段构建的核心是分离编译与运行环境：第一阶段（builder）用maven:3.9-openjdk-17等完整镜像编译打包，第二阶段（runtime）仅用JRE或distroless镜像运行jar，最终镜像不含javac、mvn、src或pom.xml，体积可从1.2GB降至约200MB。

多阶段构建的核心是把“编译”和“运行”彻底分开——编译阶段用功能齐全的镜像干活，运行阶段只留最小必要环境，不带任何编译期组件。

明确两个阶段的分工

第一阶段（builder）负责编译打包，需要 Maven/Gradle + JDK；第二阶段（runtime）只运行 jar，只需 JRE 或更轻量的 Java 运行时。两者互不干扰，最终镜像里根本不存在 javac、mvn、src 目录或 pom.xml。

• builder 阶段用 maven:3.9-openjdk-17 或 gradle:8-jdk17，执行 mvn clean package -DskipTests
• runtime 阶段必须用 AS 显式命名 builder，否则 COPY --from=builder 会失败
• 避免误用 openjdk:17-jdk-slim 作基础镜像——它仍含完整 JDK，体积超 400MB

选对运行时基础镜像

精简不是越小越好，得兼顾可用性。JRE 镜像比 JDK 小一半以上，但还要看是否预装关键依赖。

Java Development Man

Java开发手册规约集合，基于阿里巴巴Java开发手册（嵩山版）。 涵盖7大维度：编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。

下载

• amazoncorretto:17-jre-alpine：约 120–150MB，自带 ca-certificates，支持 TLS 和 DNS 解析
• gcr.io/distroless/java17：仅约 15MB，无 shell、无 /bin/sh，适合高安全场景，但无法 exec 调试
• 别直接用 scratch：Java 应用依赖 glibc 和证书，硬切会报 No such file or directory

优化 COPY 和中间产物

只拷贝真正需要的文件，同时清理构建过程产生的临时内容。

• builder 阶段先 COPY pom.xml 和 src/，避免因 COPY . 带入 .git、IDE 配置等无用文件
• 打包后用 RUN mvn clean 清理本地仓库缓存，减少层体积
• runtime 阶段只 COPY --from=builder /app/target/*.jar /app.jar，不复制任何其他路径

验证瘦身效果和运行稳定性

体积缩小不是终点，得确保应用能正常启动和对外服务。

• 构建后用 docker images 对比大小，Spring Boot 项目常见从 1.2GB 降至 200MB 左右
• 运行容器后执行 docker exec -it ls -l /，确认没有 /usr/lib/jvm/jdk-17、/root/.m2 等目录
• 检查日志是否有 NoClassDefFoundError 或 DNS 失败，说明运行时镜像缺关键组件

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南