在云原生与持续交付成为标配的今天，Docker镜像已成为软件交付的核心单元。然而，一个常见的痛点困扰着开发者：构建出的镜像往往异常臃肿，因为它不仅包含运行所需的最小环境，还塞满了编译工具、依赖缓存、源代码等大量构建期“垃圾”。【Docker Multi-stage Build 多阶段构建镜像】正是Docker为解决此问题而引入的变革性特性。其核心价值在于，它允许你在单个Dockerfile中定义多个“阶段”（Stage），并像流水线一样，将前一阶段的产出物（如编译好的二进制文件）精确地复制到后续阶段，而将构建环境本身及其所有冗余遗留在最终镜像之外。这不仅能将镜像体积缩小一个数量级，提升安全性，还能优化构建缓存，是构建生产级镜像的黄金标准。

一、 痛点深析：为什么传统单阶段镜像如此臃肿？

让我们审视一个典型的单阶段Java应用Dockerfile：

FROM maven:3.8.4-openjdk-11 AS builder
WORKDIR /app
COPY pom.xml .
RUN mvn dependency:go-offline
COPY src ./src
RUN mvn clean package -DskipTests
FROM openjdk:11-jre-slim
WORKDIR /app
COPY --from=builder /app/target/myapp.jar ./app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "/app/app.jar"]

注意：以上其实是多阶段构建的写法。一个真正的单阶段臃肿版本会是：

FROM maven:3.8.4-openjdk-11
WORKDIR /app
COPY . .
RUN mvn clean package -DskipTests 
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "/app/target/myapp.jar"]

这个镜像的最终体积将超过700MB！因为它包含了：
1. 完整的JDK（而运行仅需JRE）。
2. 整个Maven工具链及其本地仓库缓存（`.m2`目录）。
3. 所有的源代码（`src`目录）。
4. 构建过程中的中间文件。
问题：巨大的镜像导致拉取、推送速度慢，存储成本高，安全攻击面广（包含了不必要的工具），且与“一个容器一个进程，且仅包含其必需依赖”的最佳实践背道而驰。

在鳄鱼java的早期微服务实践中，一个中等规模的Spring Boot服务镜像普遍在500MB以上，导致集群节点磁盘快速告警，部署滚动更新耗时漫长。

二、 多阶段构建原理：构建流水线在Dockerfile中的具象化

【Docker Multi-stage Build 多阶段构建镜像】的语法直观而强大。其核心思想是将Dockerfile的构建过程划分为多个清晰的阶段，每个阶段可以基于不同的基础镜像开始。

关键语法：
- `FROM ... AS `：定义一个构建阶段，并为其命名。
- `COPY --from=`：在后续阶段中，从前置命名阶段复制文件，而非从主机文件系统。

工作流程：
1. 阶段一（构建器）：基于一个包含完整编译工具链的“肥”镜像（如`maven:3.8.4-openjdk-11`, `golang:1.19`），执行代码克隆、依赖下载、编译、测试等操作，生成最终的可执行产物（如JAR包、二进制文件）。
2. 阶段二（运行时）：基于一个极简的运行时镜像（如`openjdk:11-jre-slim`, `alpine`, `scratch`），从阶段一精确复制仅有的产物到当前镜像。
3. （可选）更多阶段：可以进行二次加工，如使用`upx`压缩二进制文件，或进行安全扫描。

最终，只有最后一个`FROM`指令定义的镜像层会被保留为输出镜像。中间的所有构建阶段镜像，在构建结束后会被自动清理（除非被缓存），完美实现了构建环境与运行环境的分离。

三、 实战对比：多阶段构建带来的体积“瘦身”奇迹

让我们使用文章开头正确的多阶段Dockerfile进行构建，并与想象中的臃肿单阶段版本进行理论对比。

结论：通过【Docker Multi-stage Build 多阶段构建镜像】

四、 进阶模式：不止于Java，通用构建范式

# 阶段一：构建
FROM golang:1.19-alpine AS builder
WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o main .
阶段二：运行（使用最简空的scratch镜像）
FROM scratch
COPY --from=builder /app/main .
COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/ # 复制CA证书
EXPOSE 8080
CMD ["./main"]

# 阶段一：安装依赖并构建
FROM node:18-alpine AS build 
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
RUN npm run build
阶段二：使用Nginx服务静态文件
FROM nginx:alpine
COPY --from=build /app/dist /usr/share/nginx/html
COPY nginx.conf /etc/nginx/conf.d/default.conf
EXPOSE 80