如何解决Maven多模块项目Docker构建父POM引用错误问题

核心问题 #

在producer模块目录执行docker build -t producer:1.0 .时，Docker构建上下文仅包含producer目录内的文件，无法直接访问上级目录的父pom.xml。原Dockerfile中的COPY ../pom.xml命令实际复制的是producer自身的pom.xml，导致Maven无法识别正确的父项目，抛出解析错误。

解决方案（推荐方案：从项目根目录构建） #

这种方式利用Docker的全项目上下文，无需复杂调整，兼容性最好。

步骤1：调整Dockerfile #

修改producer模块下的Dockerfile，适配项目根目录的构建上下文：

FROM openjdk:22
LABEL authors="daniel castro"

ARG MAVEN_VERSION=3.9.6
ARG USER_HOME_DIR="/root"
ARG SHA=706f01b20dec0305a822ab614d51f32b07ee11d0218175e55450242e49d2156386483b506b3a4e8a03ac8611bae96395fd5eec15f50d3013d5deed6d1ee18224
ARG BASE_URL=https://apache.osuosl.org/maven/maven-3/${MAVEN_VERSION}/binaries

RUN mkdir -p /usr/share/maven /usr/share/maven/ref \
  && curl -fsSL -o /tmp/apache-maven.tar.gz ${BASE_URL}/apache-maven-${MAVEN_VERSION}-bin.tar.gz \
  && echo "${SHA}  /tmp/apache-maven.tar.gz" | sha512sum -c - \
  && tar -xzf /tmp/apache-maven.tar.gz -C /usr/share/maven --strip-components=1 \
  && rm -f /tmp/apache-maven.tar.gz \
  && ln -s /usr/share/maven/bin/mvn /usr/bin/mvn

ENV MAVEN_HOME /usr/share/maven
ENV MAVEN_CONFIG "$USER_HOME_DIR/.m2"

# 复制项目根目录的父pom.xml
COPY pom.xml /usr/src/myapp/parent-pom.xml
# 复制producer模块所有文件
COPY producer /usr/src/myapp
WORKDIR /usr/src/myapp

# 修改producer的pom.xml，指向当前目录的父pom文件
RUN sed -i 's/<relativePath>..\/pom.xml<\/relativePath>/<relativePath>./parent-pom.xml<\/relativePath>/' pom.xml

# 执行Maven构建
RUN mvn clean install

# 复制构建产物JAR包
ARG JAR_FILE=target/producer-1.0-SNAPSHOT.jar.original
RUN cp ${JAR_FILE} /usr/src/myapp/app.jar

ENTRYPOINT ["java","-jar","app.jar"]

步骤2：执行构建命令 #

切换到项目根目录（包含父pom.xml、producer和consumer模块的目录），运行以下命令：

docker build -t producer:1.0 -f producer/Dockerfile .

优化方案：多阶段构建（更小镜像） #

使用多阶段构建分离构建和运行环境，大幅减小最终镜像体积：

# 构建阶段：使用Maven镜像完成编译打包
FROM maven:3.9.6-openjdk-22 AS builder
WORKDIR /app
# 复制父pom和producer模块文件
COPY pom.xml .
COPY producer ./producer
# 仅构建producer模块（-pl指定模块，-am自动构建依赖的父项目）
RUN mvn clean install -pl producer -am

# 运行阶段：使用轻量OpenJDK镜像运行应用
FROM openjdk:22
LABEL authors="daniel castro"
# 从构建阶段复制已打包好的JAR包
COPY --from=builder /app/producer/target/producer-1.0-SNAPSHOT.jar.original /app/app.jar
WORKDIR /app
ENTRYPOINT ["java","-jar","app.jar"]

构建命令同样在项目根目录执行：

docker build -t producer:1.0 -f producer/Dockerfile .

内容的提问来源于stack exchange，提问作者Daniel Ferreira Castro