JeecgBoot项目Docker打包失败原因分析与解决方案

问题背景

在使用JeecgBoot开源项目进行Docker打包时，开发者在Ubuntu 24系统环境下遇到了构建失败的问题。项目采用Java 8开发，数据库使用Oracle，Redis未使用Docker镜像。

错误现象

执行docker-compose up -d命令后，系统报出以下关键错误信息：

failed to solve: failed to compute cache key: failed to calculate checksum of ref e6c37338-c0a0-437a-9bef-e8594f9a3acf::urjji7l5s6u0fvny6jtaycd8w: "/target/jeecg-system-start-3.7.0.jar": not found

根本原因分析

1. 缺少Maven构建工具：JeecgBoot是一个基于Java的Spring Boot项目，需要先通过Maven进行编译打包，生成可执行的JAR文件后才能进行Docker镜像构建。

2. Docker构建流程问题：Dockerfile中直接引用了./target/jeecg-system-start-3.7.0.jar文件，但在没有Maven构建的情况下，该文件不存在。

3. 版本兼容性问题：虽然这不是导致本次错误的主要原因，但需要注意Docker Compose文件中的version: '2'已被标记为过时，建议更新。

解决方案

完整构建步骤

1. 安装必要工具

   sudo apt-get install maven
   

2. 使用Maven编译项目

   mvn clean package
   

3. 验证构建结果 检查target目录下是否生成了jeecg-system-start-3.7.0.jar文件

4. 执行Docker构建

   docker-compose up -d
   

优化建议

1. 更新Docker Compose配置：移除过时的version声明

   services:
     jeecg-boot-system:
       build:
         context: ./jeecg-module-system/jeecg-system-start
         dockerfile: Dockerfile
       restart: on-failure
       container_name: jeecg-boot-system
       image: jeecg-boot-system
       hostname: jeecg-boot-system
       ports:
         - 8080:2222
       networks:
         - jeecg-boot
   
   networks:
     jeecg-boot:
       name: jeecg_boot
   

2. 考虑使用多阶段构建：可以修改Dockerfile，将Maven构建和Docker构建整合在一起

技术原理

Java项目的Docker化通常需要两个阶段：

1. 编译阶段：使用Maven或Gradle等构建工具将源代码编译打包成可执行的JAR/WAR文件
2. 容器化阶段：将生成的构建产物打包到Docker镜像中

JeecgBoot作为典型的Spring Boot项目，遵循这一标准流程。直接跳过编译阶段会导致Docker构建时找不到必要的构建产物，从而出现上述错误。

总结

对于Java项目的Docker化部署，必须确保先完成项目的编译打包过程。JeecgBoot作为Maven项目，需要先通过mvn package命令生成JAR文件，才能进行后续的Docker镜像构建。这一流程是Java项目容器化的标准实践，理解这一点可以避免类似的构建失败问题。