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

背景介绍

在Java企业级应用开发中，Spring Boot应用的打包部署是一个常见需求。JeecgBoot作为一款基于Spring Boot的低代码开发平台，其项目结构通常包含多个模块。在实际生产环境中，我们经常需要对应用进行分离打包，即将依赖库与业务代码分离，以便于部署和更新。

传统分离打包的问题

在JeecgBoot 3.6.3版本中，使用标准的Spring Boot分离打包方式时，所有依赖（包括业务模块生成的jeecg前缀JAR包）都会被提取到外部lib目录中。这种打包方式虽然实现了依赖分离，但在实际运维中会带来以下问题：

1. 业务代码更新复杂：每次更新都需要从众多依赖JAR中找出业务相关的JAR进行替换
2. 部署包管理困难：难以区分核心依赖和业务代码
3. 更新效率低下：需要人工识别哪些JAR需要更新

优化方案设计

针对上述问题，我们可以通过定制Maven打包配置，实现更合理的分离打包策略：

核心思路

1. 将第三方依赖与业务代码分离
2. 业务模块JAR保留在主JAR包内
3. 仅将稳定的第三方依赖提取到外部

具体实现

通过修改pom.xml文件中的spring-boot-maven-plugin配置，可以实现更精细的打包控制：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <layout>ZIP</layout>
        <includes>
            <include>
                <groupId>com.jeecg</groupId>
                <artifactId>*</artifactId>
            </include>
        </includes>
    </configuration>
</plugin>

这种配置会确保所有com.jeecg组件的业务代码保留在主JAR中，而其他第三方依赖会被提取到外部lib目录。

完整打包配置示例

以下是一个完整的分离打包配置示例，包含了资源文件和依赖的处理：

<plugins>
    <!-- Spring Boot打包插件 -->
    <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
        <configuration>
            <layout>ZIP</layout>
            <includes>
                <include>
                    <groupId>com.jeecg</groupId>
                    <artifactId>*</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>com.jeecg</excludeGroupIds>
                </configuration>
            </execution>
        </executions>
    </plugin>
    
    <!-- 资源文件处理 -->
    <plugin>
        <artifactId>maven-resources-plugin</artifactId>
        <executions>
            <execution>
                <id>copy-resources</id>
                <phase>package</phase>
                <goals>
                    <goal>copy-resources</goal>
                </goals>
                <configuration>
                    <resources>
                        <resource>
                            <directory>${project.build.directory}/classes</directory>
                            <includes>
                                <include>*.xml</include>
                                <include>*.yml</include>
                                <include>jeecg/**</include>
                                <include>static/**</include>
                                <include>templates/**</include>
                            </includes>
                        </resource>
                    </resources>
                    <outputDirectory>${project.build.directory}/config</outputDirectory>
                </configuration>
            </execution>
        </executions>
    </plugin>
</plugins>

启动方式

优化后的打包结构启动命令如下：

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

优势分析

这种优化后的打包方式具有以下优势：

1. 更新便捷：业务代码变更只需替换主JAR包即可
2. 依赖管理清晰：第三方依赖与业务代码明确分离
3. 部署效率高：减少了人工识别和选择JAR包的过程
4. 结构合理：符合"稳定依赖与易变代码分离"的设计原则

注意事项

1. 确保业务模块的groupId统一使用com.jeecg（或项目自定义的前缀）
2. 对于多模块项目，需要确保各子模块的pom配置一致
3. 在CI/CD流程中，需要相应调整构建脚本以适应新的打包结构
4. 测试阶段需验证所有依赖是否正确加载

总结

通过对JeecgBoot项目打包策略的优化，我们实现了更合理的JAR分离打包方案，解决了业务代码更新不便的问题。这种方案不仅适用于JeecgBoot项目，对于其他基于Spring Boot的多模块企业级应用也具有参考价值。在实际应用中，开发团队可以根据项目具体情况调整打包策略，找到最适合自身项目的部署方案。