构建 Maven 项目并使用多阶段 Docker 构建部署 Java 应用

本文详解如何正确配置多阶段 dockerfile 构建 maven 项目，解决因路径错误导致的 `lstat target: no such file or directory` 构建失败问题，并提供可直接复用的最佳实践写法。

在 Docker 中构建 Maven 项目时，常见的误区是混淆构建阶段（builder）与运行阶段（runtime）的工作目录和文件可见性。原始 Dockerfile 失败的根本原因在于：第二阶段（FROM maven:...）是一个全新的、空的容器环境，它无法直接访问第一阶段中 /tmp/target/ 下生成的 JAR 文件，除非显式通过 COPY --from= 跨阶段复制。

原始写法：

FROM maven:3.8.1-openjdk-17 as builder
COPY src /tmp/src/
COPY pom.xml /tmp/
WORKD
IR /tmp/
RUN mvn clean install

FROM maven:3.8.1-openjdk-17
COPY target/*.jar app.jar  # ❌ 错误：此阶段无 target 目录！

此处 target/*.jar 在第二阶段根本不存在——因为 mvn clean install 仅在 builder 阶段执行，产物只存在于该阶段的 /tmp/target/ 中。

✅ 正确做法是：利用多阶段构建的 --from 语法，明确指定从 builder 阶段复制产物，并给出其绝对路径（因 WORKDIR /tmp 已设置，JAR 实际位于 /tmp/target/）：

FROM maven:3.8.1-openjdk-17 AS builder
COPY src/ ./src/
COPY pom.xml ./
RUN mvn clean package -DskipTests

FROM openjdk:17-jre-slim  # ✅ 更佳选择：运行时无需 Maven，用轻量 JRE 镜像
WORKDIR /app
COPY --from=builder /tmp/target/*.jar app.jar
EXPOSE 8081
ENTRYPOINT ["java", "-jar", "app.jar"]

? 关键优化说明：

• 使用 AS builder 显式命名构建阶段，便于 --from=builder 引用；
• COPY 源路径应为 builder 阶段中实际生成路径（如 /tmp/target/*.jar），而非相对路径；
• 运行阶段推荐 openjdk:17-jre-slim 而非 maven:...：避免将 Maven、编译工具等冗余依赖打入生产镜像，显著减小镜像体积并提升安全性；
• mvn clean package -DskipTests 比 install 更精准：package 即可生成 JAR，跳过安装到本地仓库步骤，提升构建效率；
• 若项目含子模块，请确保 pom.xml 位置与 COPY 路径匹配，或在 WORKDIR 后统一操作。

? 提示：可通过 docker build --target builder -o ./output/ . 单独导出构建产物用于调试；也可添加 .dockerignore 排除 target/、node_modules/ 等目录，防止意外 COPY 影响构建缓存。

遵循以上结构，即可稳定实现“构建与运行分离”的最佳实践，兼顾可重复性、安全性和镜像精简性。