Maven项目依赖优化与Jar包瘦身实战

1. 问题背景：Maven项目为何越打包越大？

最近接手一个老项目时，发现打包后的Jar包竟然有300多MB，构建时间长达5分钟。这显然不正常——一个常规的Spring Boot应用通常在30-50MB左右。通过分析发现，项目中存在大量冗余依赖，包括：

• 同一依赖的不同版本（如Guava 18.0和Guava 30.0）
• 传递性依赖带来的无用库（如某个数据库驱动包引入了旧版日志框架）
• 测试依赖被打进生产包（JUnit、Mockito等）
• 本地开发的工具类库（Lombok、MapStruct处理器）

这种情况在长期迭代的项目中特别常见。每次新增功能就加依赖，但很少有人去清理不再使用的旧依赖。最终导致：

1. 构建速度变慢（Maven需要下载和处理更多依赖）
2. 包体积膨胀（冗余类被重复打包）
3. 甚至可能引发类冲突（相同类的不同版本共存）

2. 核心工具：maven-dependency-plugin深度解析

解决这个问题的核心工具是Maven自带的dependency插件。它有几个关键功能：

2.1 依赖树分析

bash复制mvn dependency:tree -Dverbose

加上-Dverbose参数会显示冲突的依赖版本。例如看到这样的输出：

code复制[INFO] +- com.google.guava:guava:jar:30.0-jre:compile
[INFO] \- com.third.library:some-lib:jar:1.0:compile
[INFO]    \- com.google.guava:guava:jar:18.0:compile

说明项目直接依赖了Guava 30.0，但某个第三方库依赖了18.0版本，需要处理冲突。

2.2 依赖冗余检测

bash复制mvn dependency:analyze

这个命令会：

1. 找出声明了但未使用的依赖（Unused declared dependencies）
2. 找出使用了但未声明的依赖（Used undeclared dependencies）

注意：测试代码使用的依赖在默认情况下不会被分析，需要加上-DincludeScope=test参数

2.3 依赖排除实践

发现冲突后，有两种处理方式：

1. 在pom.xml中排除特定传递依赖：

xml复制<dependency>
    <groupId>com.third.library</groupId>
    <artifactId>some-lib</artifactId>
    <exclusions>
        <exclusion>
            <groupId>com.google.guava</groupId>
            <artifactId>guava</artifactId>
        </exclusion>
    </exclusions>
</dependency>

2. 在dependencyManagement中强制指定版本：

xml复制<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.google.guava</groupId>
            <artifactId>guava</artifactId>
            <version>30.0-jre</version>
        </dependency>
    </dependencies>
</dependencyManagement>

3. 实战优化：三步瘦身方案

3.1 第一步：基础清理（预计节省20%体积）

1. 移除Lombok等编译期依赖：

xml复制<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.24</version>
    <scope>provided</scope> <!-- 关键修改 -->
</dependency>

2. 处理测试依赖：

xml复制<dependency>
    <groupId>junit</groupId>
    <artifactId>junit</artifactId>
    <version>4.13.2</version>
    <scope>test</scope> <!-- 确保是test范围 -->
</dependency>

3. 清理重复依赖：

bash复制mvn dependency:analyze-duplicate

3.2 第二步：高级优化（再节省30%）

1. 使用maven-shade-plugin剔除不需要的类：

xml复制<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.3.0</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
            <configuration>
                <minimizeJar>true</minimizeJar>
                <filters>
                    <filter>
                        <artifact>*:*</artifact>
                        <excludes>
                            <exclude>META-INF/*.SF</exclude>
                            <exclude>META-INF/*.DSA</exclude>
                        </excludes>
                    </filter>
                </filters>
            </configuration>
        </execution>
    </executions>
</plugin>

2. 按需引入依赖（适合组件化项目）：

xml复制<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
        </exclusion>
    </exclusions>
</dependency>

3.3 第三步：构建加速（提升50%速度）

1. 并行构建：

bash复制mvn -T 1C clean install 

1C表示每个CPU核心一个线程

2. 跳过测试：

bash复制mvn -DskipTests=true package

3. 增量编译（IDEA默认支持）：

bash复制mvn compile -pl module-name -am

4. 避坑指南：常见问题解决

4.1 类找不到问题

优化后可能出现ClassNotFoundException，解决方法：

1. 检查dependency:analyze报告的Used undeclared dependencies
2. 确认shade插件没有过度排除
3. 使用mvn dependency:build-classpath查看运行时类路径

4.2 性能对比数据

优化前后的典型对比：

4.3 推荐插件组合

1. 依赖分析：

   • maven-dependency-plugin
   • maven-enforcer-plugin（强制依赖规则）

2. 构建加速：

   • maven-compiler-plugin（增量编译）
   • maven-jar-plugin（精简MANIFEST）

3. 高级优化：

   • spring-boot-thin-launcher（Spring Boot瘦身）
   • jlink（JDK模块化）

5. 长效维护机制

1. 在CI流程中加入依赖检查：

xml复制<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-enforcer-plugin</artifactId>
    <version>3.0.0</version>
    <executions>
        <execution>
            <id>enforce</id>
            <configuration>
                <rules>
                    <banDuplicatePomDependencyVersions/>
                    <dependencyConvergence/>
                </rules>
            </configuration>
            <goals>
                <goal>enforce</goal>
            </goals>
        </execution>
    </executions>
</plugin>

2. 定期执行依赖清理：

bash复制mvn versions:display-dependency-updates
mvn versions:use-latest-versions

3. 使用BOM管理版本：

xml复制<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>2.7.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>