Java项目打包实战：IDEA与Maven插件对比指南

1. 项目概述

在Java开发中，将项目打包成可执行的JAR文件是每个开发者必备的基础技能。作为使用IntelliJ IDEA进行日常开发的工程师，我发现很多新手对IDEA自带的打包工具和Maven插件的使用场景区分不够清晰。本文将基于我多年企业级项目打包经验，详细对比分析四种主流打包方式的特点和适用场景。

2. 核心打包方式解析

2.1 IDEA自带打包工具

IDEA提供了两种原生打包方案，适合快速生成简单JAR文件：

标准JAR打包流程：

1. 项目右键 -> Open Module Settings
2. Artifacts -> + -> JAR -> From modules...
3. 选择主类(Main Class)
4. Build -> Build Artifacts...

注意：这种方式不会打包依赖库，适合不含第三方依赖的简单项目。我曾在一个工具类项目中采用此方式，最终生成的JAR仅87KB。

包含依赖的打包方案：

1. 在上述步骤中选择"Extract to the target JAR"
2. 或手动添加lib目录存放依赖JAR
3. 配置MANIFEST.MF的Class-Path属性

实测发现，当项目依赖超过20个第三方库时，这种方式的维护成本会显著增加。去年在金融项目中使用时，每次依赖变更都需要重新调整lib目录结构。

2.2 Maven插件打包方案

2.2.1 maven-shade-plugin深度解析

这是目前企业级项目最常用的打包插件，其核心优势在于：

• 自动解决依赖冲突
• 支持资源文件过滤
• 可执行JAR生成

典型配置示例：

xml复制<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.4.1</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
            <configuration>
                <transformers>
                    <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                        <mainClass>com.example.Main</mainClass>
                    </transformer>
                </transformers>
            </configuration>
        </execution>
    </executions>
</plugin>

实战经验：

1. 遇到同名资源文件冲突时，使用<filters>配置解决
2. 大型项目建议添加<minimizeJar>true</minimizeJar>减少体积
3. 使用`true生成精简pom

2.2.2 maven-assembly-plugin高级用法

该插件更适合需要定制化打包结构的场景，比如：

• 生成包含文档、配置文件的发布包
• 创建分模块的ZIP/TAR归档
• 特殊目录结构需求

经典配置模板：

xml复制<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-assembly-plugin</artifactId>
    <version>3.5.0</version>
    <configuration>
        <descriptorRefs>
            <descriptorRef>jar-with-dependencies</descriptorRef>
        </descriptorRefs>
        <archive>
            <manifest>
                <mainClass>com.example.Main</mainClass>
            </manifest>
        </archive>
    </configuration>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>single</goal>
            </goals>
        </execution>
    </executions>
</plugin>

性能优化技巧：

1. 使用自定义assembly.xml替代descriptorRefs获得更灵活控制
2. 通过<fileSets>精确控制文件包含规则
3. 大型项目建议分模块打包后组合

3. 方案对比与选型建议

3.1 功能对比表

3.2 性能实测数据

基于Spring Boot 2.7项目测试(含48个依赖)：

4. 高级应用场景

4.1 多环境打包策略

在企业级项目中，我通常结合profile实现环境差异化打包：

xml复制<profiles>
    <profile>
        <id>dev</id>
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
        <build>
            <plugins>
                <plugin>
                    <!-- 开发环境特殊配置 -->
                </plugin>
            </plugins>
        </build>
    </profile>
</profiles>

4.2 安全加固方案

重要项目打包时需要额外注意：

1. 使用maven-enforcer-plugin检查依赖漏洞
2. 配置<archive>添加数字签名
3. 排除敏感配置文件

5. 常见问题排查

问题1：No main manifest attribute

• 检查MANIFEST.MF是否包含Main-Class
• shade插件需确认transformer配置正确

问题2：ClassNotFoundException

• 使用mvn dependency:tree检查依赖是否完整
• assembly插件检查descriptor包含范围

问题3：资源文件丢失

• 确认资源目录在<resources>中声明
• shade插件添加<ResourceTransformer>

问题4：版本冲突

• 使用mvn dependency:analyze检测
• shade插件配置<relocations>

6. 最佳实践建议

1. 中小型项目优先选用shade-plugin
2. 需要分模块部署时考虑assembly-plugin
3. 持续集成环境中建议：

   bash复制mvn clean package -DskipTests
   

4. 定期清理本地仓库避免缓存问题：

   bash复制mvn dependency:purge-local-repository
   

在微服务架构实践中，我发现将核心模块打包为独立JAR并通过shade-plugin优化，可以使容器镜像体积减少40%以上。特别是在Kubernetes环境中，精简的JAR包能显著提升调度效率。