Docker构建Java项目时无法读取依赖镜像中Jar文件的问题求助

首先，咱们来拆解一下你遇到的问题：你本地构建时能正常拿到CMS的包，但Docker构建APP时找不到依赖，核心原因是Docker容器的Maven仓库和本地是完全隔离的，而且当前Dockerfile配置没有正确传递CMS的构建产物。下面一步步帮你解决：

第一步：确认CMS镜像是否正确安装了依赖包 #

你的CMS Dockerfile里执行了mvn clean install，但得先验证这个操作是否真的把APP需要的包放到了容器的Maven仓库中。跑个命令进容器检查：

docker run --rm -it project-cms:latest sh
# 进入容器后查看Maven仓库里的CMS相关包
cd ~/.m2/repository/com/xxxx/
ls -la

如果看不到publishing-site相关的目录和对应版本的jar（尤其是带classes分类器的），那问题出在CMS的构建配置：

• 检查CMS的pom.xml，确认groupId、artifactId、version和APP依赖的com.xxxx:publishing-site:jar:classes:1.02.26完全匹配
• 如果APP依赖的是带classes分类器的jar，CMS的pom.xml里需要配置生成这个包，比如：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-jar-plugin</artifactId>
      <executions>
        <execution>
          <id>classes-jar</id>
          <goals>
            <goal>jar</goal>
          </goals>
          <configuration>
            <classifier>classes</classifier>
            <includes>
              <include>**/*</include>
            </includes>
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

修正后重新构建CMS镜像，再验证仓库里是否有对应的包。

第二步：优化Docker构建流程（多阶段构建） #

你当前用CMS镜像作为APP的基础镜像，虽然理论上能继承Maven仓库，但容易出现镜像冗余（包含CMS源码）和路径权限问题。推荐用多阶段构建，既高效又逻辑清晰：

1. 构建CMS并导出Maven仓库 #

先写一个专门构建CMS的Dockerfile（和CMS项目放在一起）：

# 阶段1：构建CMS并安装到Maven仓库
FROM maven:3.5.2-jdk-8-alpine AS cms-builder
WORKDIR /project-cms
# 先复制pom.xml，利用Docker缓存加速依赖下载
COPY pom.xml .
RUN mvn dependency:go-offline
# 再复制源码执行构建
COPY src ./src
RUN mvn clean install

构建这个镜像：

docker build -t cms-builder:latest ./project-cms

2. 基于CMS的Maven仓库构建APP #

然后APP的Dockerfile改成这样（和APP项目放在一起）：

# 阶段2：构建APP，复用CMS的Maven仓库
FROM maven:3.5.2-jdk-8-alpine AS app-builder
WORKDIR /app
# 从CMS构建阶段复制已安装好依赖的Maven仓库
COPY --from=cms-builder /root/.m2/repository /root/.m2/repository
# 同样先复制pom.xml缓存依赖
COPY pom.xml .
RUN mvn dependency:go-offline
# 复制源码执行构建
COPY src ./src
RUN mvn clean install && mvn build

# 阶段3：用轻量Tomcat镜像运行APP（比直接用Maven run更高效）
FROM tomcat:8.5-jdk8-alpine
WORKDIR /usr/local/tomcat/webapps
# 复制APP构建好的war包到Tomcat
COPY --from=app-builder /app/target/*.war ./ROOT.war
EXPOSE 8080
CMD ["catalina.sh", "run"]

这样构建APP镜像时，Maven能直接找到CMS的依赖，而且最终运行的镜像只有Tomcat和war包，体积小很多。

第三步：托管CMS构建镜像到AWS ECR，实现无Maven构建 #

你需要把cms-builder镜像推到ECR，这样开发者不需要本地安装Maven，只要有Docker就能构建APP：

1. 先登录AWS ECR：

aws ecr get-login-password --region <你的AWS区域> | docker login --username AWS --password-stdin <你的AWS账号ID>.dkr.ecr.<你的AWS区域>.amazonaws.com

2. 给镜像打标签并推送：

docker tag cms-builder:latest <你的AWS账号ID>.dkr.ecr.<你的AWS区域>.amazonaws.com/cms-builder:latest
docker push <你的AWS账号ID>.dkr.ecr.<你的AWS区域>.amazonaws.com/cms-builder:latest

3. 开发者修改APP的Dockerfile，从ECR拉取CMS构建镜像：

FROM maven:3.5.2-jdk-8-alpine AS app-builder
WORKDIR /app
# 替换成你的ECR地址
COPY --from=<你的AWS账号ID>.dkr.ecr.<你的AWS区域>.amazonaws.com/cms-builder:latest /root/.m2/repository /root/.m2/repository
COPY pom.xml .
RUN mvn dependency:go-offline
COPY src ./src
RUN mvn clean install && mvn build

# 运行阶段同上
FROM tomcat:8.5-jdk8-alpine
WORKDIR /usr/local/tomcat/webapps
COPY --from=app-builder /app/target/*.war ./ROOT.war
EXPOSE 8080
CMD ["catalina.sh", "run"]

这样开发者只要执行docker build -t project-app:latest ./project-app就能完成构建，完全不需要本地安装Maven。

额外注意点 #

• 去掉Dockerfile构建阶段的VOLUME指令：VOLUME是运行时用来挂载目录的，构建阶段使用会导致后续的文件复制不生效，反而添乱。
• 利用Docker缓存：先复制pom.xml再执行mvn dependency:go-offline，这样只要pom.xml不变，下次构建会跳过依赖下载，速度快很多。

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