JEECG Boot项目Docker打包失败问题分析与解决方案

问题背景

在使用JEECG Boot开源项目进行Docker容器化部署时，开发人员遇到了打包失败的问题。系统环境为Ubuntu 24，JDK 1.8，Git 2.43，但没有安装Maven构建工具。Docker版本为28，数据库采用Oracle和Redis，但均未使用Docker镜像。

错误现象

执行docker-compose up -d命令时，系统报错显示无法找到/target/jeecg-system-start-3.7.0.jar文件。错误信息明确指出构建过程中计算缓存键失败，原因是目标JAR文件不存在。

根本原因分析

1. Maven构建缺失：JEECG Boot是一个基于Java的Spring Boot项目，标准的构建流程需要先通过Maven编译打包生成可执行的JAR文件。在没有Maven的情况下直接尝试Docker构建，自然无法找到所需的JAR文件。

2. Docker构建流程误解：Dockerfile中的ADD指令试图直接从项目目录的target文件夹获取JAR文件，但该文件尚未生成。正确的流程应该是先构建项目，再执行Docker镜像构建。

3. 版本兼容性问题：虽然报错信息中提到了version属性已过时的警告，但这并非导致构建失败的主要原因，只是Docker Compose版本兼容性的一个小提示。

解决方案

完整构建流程

1. 安装Maven：首先需要在构建环境中安装Maven构建工具。可以通过包管理器安装：

   sudo apt-get install maven
   

2. 项目编译打包：在项目根目录执行Maven构建命令：

   mvn clean package
   

3. 验证构建结果：确保target目录下生成了正确的JAR文件，文件名应与Dockerfile中指定的名称一致。

4. 执行Docker构建：在确认JAR文件存在后，再执行Docker构建命令：

   docker-compose up -d
   

Dockerfile优化建议

为避免类似问题，可以在Dockerfile中添加构建阶段，实现从源代码到最终镜像的一体化构建：

FROM maven:3.6.3-jdk-8 AS build
WORKDIR /app
COPY . .
RUN mvn clean package

FROM anapsix/alpine-java:8_server-jre_unlimited
COPY --from=build /app/jeecg-module-system/jeecg-system-start/target/jeecg-system-start-*.jar /jeecg-boot/jeecg-system-start.jar
WORKDIR /jeecg-boot
EXPOSE 2222
ENTRYPOINT ["java", "-jar", "jeecg-system-start.jar"]

经验总结

1. 理解构建流程：容器化部署Java应用时，必须清楚区分开发构建阶段和容器打包阶段。

2. 环境准备：确保构建环境中安装了所有必要的工具链，特别是像Maven这样的构建工具。

3. 错误排查：当Docker构建失败时，首先检查前置条件是否满足，如依赖文件是否存在、路径是否正确等。

4. 多阶段构建：对于复杂的项目，考虑使用Docker的多阶段构建功能，可以简化部署流程并减少最终镜像大小。

通过遵循正确的构建流程和上述建议，可以避免类似JEECG Boot项目Docker打包失败的问题，实现顺利的容器化部署。