如何配置Spring Maven项目Dockerfile，无需手动执行mvn wrapper:wrapper

我维护的代码仓库主分支，期望用户克隆后仅执行docker compose up --build就能通过Docker Desktop构建运行项目，但当前直接执行该命令会构建失败，必须先进入backend-spring目录执行mvn wrapper:wrapper，再执行构建命令才能成功。

错误重现 #

1. 克隆仓库到本地：

git clone git@github.com:zephyrdark/SA58_AlvinLee_Fibonacci.git

2. 进入仓库根目录执行：

docker compose up --build

3. 构建失败，关键错误日志片段：

...
 => ERROR [backend deps 5/5] RUN --mount=type=bind,source=pom.xml,target=pom.xml     --mount=type=cache,target=/root/.m2 ./mvnw dependency:go-offline -DskipTests 

需求 #

修改后端Dockerfile，让用户无需手动执行mvn wrapper:wrapper，直接执行docker compose up --build即可完成构建运行。

提供三种可行方案，可根据项目需求选择：

方案1：用系统Maven替代Maven Wrapper #

修改backend-spring目录下的Dockerfile，放弃依赖仓库中的Maven Wrapper文件，直接使用镜像内置的Maven环境：

# 替换为带Maven的OpenJDK基础镜像
FROM eclipse-temurin:17-jdk-jammy AS builder

WORKDIR /build

# 复制pom.xml并离线下载依赖
COPY pom.xml .
RUN --mount=type=cache,target=/root/.m2 mvn dependency:go-offline -DskipTests

# 复制源码并构建项目
COPY src/ src/
RUN mvn package -DskipTests

# 运行阶段保持原有配置
FROM eclipse-temurin:17-jre-jammy

RUN adduser \
    --disabled-password \
    --gecos "" \
    --home "/nonexistent" \
    --shell "/sbin/nologin" \
    --no-create-home \
    --uid "10001" \
    appuser

WORKDIR /app
COPY --from=builder /build/target/*.jar app.jar

USER appuser
EXPOSE 8080
CMD ["java", "-jar", "app.jar"]

该方案无需维护仓库中的Wrapper文件，完全依赖镜像内的Maven环境，从根源避免缺失Wrapper文件导致的构建失败。

方案2：在Docker构建阶段自动生成Wrapper #

如果坚持使用Maven Wrapper，可在Docker的builder阶段自动生成Wrapper文件，无需用户本地操作：

FROM eclipse-temurin:17-jdk-jammy AS builder

WORKDIR /build

# 复制pom.xml并生成指定版本的Maven Wrapper
COPY pom.xml .
RUN mvn wrapper:wrapper -Dmaven=3.9.6 # 可根据项目需求调整Maven版本

# 使用生成的Wrapper下载依赖
RUN --mount=type=cache,target=/root/.m2 ./mvnw dependency:go-offline -DskipTests

# 复制源码并构建
COPY src/ src/
RUN ./mvnw package -DskipTests

# 运行阶段配置不变
FROM eclipse-temurin:17-jre-jammy

RUN adduser \
    --disabled-password \
    --gecos "" \
    --home "/nonexistent" \
    --shell "/sbin/nologin" \
    --no-create-home \
    --uid "10001" \
    appuser

WORKDIR /app
COPY --from=builder /build/target/*.jar app.jar

USER appuser
EXPOSE 8080
CMD ["java", "-jar", "app.jar"]

此方案会在Docker构建过程中自动生成Wrapper文件，保持使用Wrapper的习惯，缺点是缓存失效时会重复生成Wrapper。

方案3：提交完整Wrapper文件到仓库 #

最彻底的解决方式是在本地生成完整的Maven Wrapper文件并提交到仓库：

1. 在backend-spring目录执行指定版本的Wrapper生成命令：

mvn wrapper:wrapper -Dmaven=3.9.6

2. 确认生成以下文件：
   • mvnw（Linux/Mac执行脚本）
   • mvnw.cmd（Windows执行脚本）
   • .mvn/wrapper/maven-wrapper.jar
   • .mvn/wrapper/maven-wrapper.properties
3. 将这些文件提交到Git仓库。

用户克隆仓库后会直接获取完整的Wrapper文件，无需修改Dockerfile即可正常执行docker compose up --build。

修改完成后，按以下步骤测试：

1. 将仓库克隆到全新的本地目录
2. 直接执行docker compose up --build
3. 确认构建成功，前端可通过http://localhost:3000访问，后端APIhttp://localhost:8080正常响应

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