JEECG-Boot项目JAR分离打包优化实践

背景介绍

在JEECG-Boot 3.6.3版本中，开发者反馈了一个关于JAR分离打包的问题。当使用分离式打包时，业务代码相关的JAR文件（以jeecg前缀开头的）也被放到了外部lib目录中，这给后续的更新部署带来了不便。本文将深入分析这个问题，并提供优化建议。

问题分析

JEECG-Boot是一个基于Spring Boot的快速开发平台，采用微服务架构设计。在标准的Spring Boot应用中，JAR分离打包是一种常见的优化手段，它可以将应用依赖的第三方库与业务代码分离，从而：

1. 减小主JAR包体积
2. 加快构建和部署速度
3. 便于依赖管理

然而，当前JEECG-Boot的分离打包配置将所有依赖（包括业务模块）都提取到了外部lib目录，这导致：

• 更新业务代码时需要逐个查找并替换lib目录下的相关JAR
• 增加了部署复杂度
• 不利于版本管理和回滚

解决方案

1. 修改Maven打包配置

核心思路是通过Spring Boot Maven插件的配置，控制哪些依赖需要内嵌在主JAR中，哪些需要外置。

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <layout>ZIP</layout>
        <includes>
            <!-- 包含业务模块 -->
            <include>
                <groupId>org.jeecgframework.boot</groupId>
                <artifactId>jeecg-*</artifactId>
            </include>
        </includes>
    </configuration>
</plugin>

2. 优化后的完整配置示例

<plugins>
    <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
        <configuration>
            <layout>ZIP</layout>
            <includes>
                <!-- 包含所有jeecg开头的业务模块 -->
                <include>
                    <groupId>org.jeecgframework.boot</groupId>
                    <artifactId>jeecg-*</artifactId>
                </include>
            </includes>
        </configuration>
    </plugin>
    
    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-dependency-plugin</artifactId>
        <executions>
            <execution>
                <id>copy-dependencies</id>
                <phase>package</phase>
                <goals>
                    <goal>copy-dependencies</goal>
                </goals>
                <configuration>
                    <outputDirectory>${project.build.directory}/lib</outputDirectory>
                    <!-- 排除业务模块 -->
                    <excludeGroupIds>org.jeecgframework.boot</excludeGroupIds>
                </configuration>
            </execution>
        </executions>
    </plugin>
    
    <!-- 其他插件配置保持不变 -->
</plugins>

3. 启动命令调整

优化后，启动命令保持不变：

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

实施效果

采用上述优化方案后：

1. 业务模块（jeecg-*）会被打包到主JAR中
2. 第三方依赖会被提取到lib目录
3. 更新业务代码只需替换主JAR即可
4. 更新第三方依赖只需替换lib目录下相应JAR

最佳实践建议

1. 版本管理：为业务JAR和第三方依赖分别建立版本管理策略
2. 构建优化：考虑使用Maven Profile区分开发环境和生产环境打包配置
3. 部署流程：建立自动化部署脚本，减少人工操作错误
4. 依赖监控：定期检查并更新第三方依赖版本

总结

通过对JEECG-Boot项目JAR分离打包配置的优化，我们实现了业务代码与第三方依赖的合理分离，简化了部署更新流程。这种优化不仅适用于JEECG-Boot，也可以作为其他Spring Boot项目JAR分离打包的参考方案。开发者应根据实际项目需求，灵活调整打包策略，找到最适合自己项目的部署方案。