JeecgBoot项目JAR分离打包优化实践

背景概述

在Java应用部署过程中，JAR包分离打包是一种常见的优化手段，尤其对于像JeecgBoot这样的企业级快速开发框架。传统的单体打包方式会导致每次更新都需要重新部署整个应用包，而分离打包则可以将依赖库与业务代码分离，提高部署效率。

分离打包的常见问题

在实际使用JeecgBoot 3.6.3版本进行分离打包时，开发者遇到了一个典型问题：业务代码相关的JAR文件（以jeecg前缀命名的）也被放到了外部lib目录中。这导致每次更新时都需要：

1. 确定哪些业务模块有更新
2. 手动更新lib目录下对应的JAR包
3. 增加了部署的复杂度和出错概率

技术原理分析

Spring Boot的默认打包机制会将所有依赖（包括业务模块）打包成一个可执行的JAR文件。当采用分离打包策略时，通常的做法是：

1. 使用spring-boot-maven-plugin配置ZIP布局
2. 通过maven-dependency-plugin将依赖复制到指定目录
3. 使用maven-resources-plugin处理静态资源

优化解决方案

针对JeecgBoot项目的特性，我们可以采用以下优化方案：

1. 自定义依赖分类

在pom.xml中明确定义哪些依赖应该外置，哪些应该内置：

<configuration>
    <includes>
        <!-- 排除业务模块 -->
        <include>
            <groupId>org.jeecgframework.boot</groupId>
            <artifactId>jeecg-*</artifactId>
        </include>
    </includes>
</configuration>

2. 多模块打包策略

对于JeecgBoot的多模块项目，建议：

1. 将核心启动模块(jeecg-system-start)作为主模块
2. 业务模块作为依赖引入
3. 在打包时保留业务模块在主JAR中

3. 启动参数优化

使用Spring Boot的loader.path参数指定外部依赖路径：

java -jar -Dfile.encoding=UTF-8 -Dloader.path=lib jeecg-system.jar

实施建议

1. 版本控制：确保所有模块版本一致，避免依赖冲突
2. 构建顺序：在多模块项目中，先构建依赖模块再构建主模块
3. 测试验证：部署前在测试环境验证分离打包效果
4. 文档记录：记录每个业务模块的版本和变更历史

最佳实践

对于JeecgBoot项目，推荐采用以下打包结构：

jeecg-system-start.jar (包含所有业务模块)
├── lib/ (第三方依赖)
├── config/ (配置文件)
└── static/ (静态资源)

这种结构下，业务更新只需替换主JAR文件，而第三方依赖可以长期保持不变。

总结

JeecgBoot项目的JAR分离打包优化需要平衡部署便利性和性能需求。通过合理配置Maven插件和Spring Boot打包策略，可以实现业务代码内置而第三方依赖外置的理想状态。这种方案既减少了部署包的大小，又简化了更新流程，特别适合频繁更新的业务系统。