本文详解如何正确配置多阶段 dockerfile 构建 maven 项目，解决因路径错误导致的 `lstat target: no such file or directory` 构建失败问题，并提供可直接复用的最佳实践写法。
在 Docker 中构建 Maven 项目时，常见的误区是混淆构建阶段（builder）与运行阶段（runtime）的工作目录和文件可见性。原始 Dockerfile 失败的根本原因在于：第二阶段（FROM maven:...）是一个全新的、空的容器环境，它无法直接访问第一阶段中 /tmp/target/ 下生成的 JAR 文件，除非显式通过 COPY --from=<stage-name> 跨阶段复制。
原始写法：
FROM maven:3.8.1-openjdk-17 as builder COPY src /tmp/src/ COPY pom.xml /tmp/ WORKDIR /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/）：
立即学习“Java免费学习笔记（深入）”；
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 影响构建缓存。
遵循以上结构，即可稳定实现“构建与运行分离”的最佳实践，兼顾可重复性、安全性和镜像精简性。
