1. 问题背景为什么你的Maven构建越来越臃肿最近接手一个老项目执行mvn clean package时发现控制台输出刷屏了整整5分钟。打开target目录一看生成的fat jar竟然有120MB这让我想起刚入行时犯过的错误——无脑引入依赖导致构建产物膨胀。今天我们就来聊聊如何给Maven项目瘦身。典型症状包括构建时间超过3分钟正常中小型项目应在1分钟内最终jar包超过50MB业务代码通常不超过10MB依赖树中存在大量未使用的传递依赖用mvn dependency:tree查看经验之谈我曾见过一个Spring Boot项目引入了整组AWS SDK却只用到了S3客户端仅这一项就增加了28MB无用依赖2. 核心工具链精准分析依赖关系2.1 依赖可视化工具mvn dependency:tree -Dverbose tree.txt这个命令会生成完整的依赖树注意观察标有omitted for conflict的版本冲突相同groupId下重复引入的不同版本明显与业务无关的依赖如测试库被打入运行时2.2 依赖分析插件在pom.xml中添加plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-dependency-plugin/artifactId version3.3.0/version executions execution idanalyze/id goalsgoalanalyze-only/goal/goals configuration failOnWarningtrue/failOnWarning /configuration /execution /executions /plugin执行mvn compile dependency:analyze会提示Unused declared dependencies声明但未使用的依赖Used undeclared dependencies未声明但实际使用的依赖3. 实战瘦身三部曲3.1 第一步修剪直接依赖案例某金融项目pom.xml原始片段dependencies !-- 原始写法 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-data-jpa/artifactId /dependency优化方案dependencies !-- 精准引入 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId exclusions exclusion groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-tomcat/artifactId /exclusion /exclusions /dependency !-- 按需引入JPA组件 -- dependency groupIdorg.springframework/groupId artifactIdspring-orm/artifactId /dependency dependency groupIdorg.hibernate/groupId artifactIdhibernate-core/artifactId /dependency关键技巧使用exclusions剔除starter中的非必要组件优先引入基础库而非全量starter对于Jackson等通用库保持版本统一3.2 第二步压缩资源文件在maven-resources-plugin中添加过滤plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-resources-plugin/artifactId configuration nonFilteredFileExtensions nonFilteredFileExtensionpdf/nonFilteredFileExtension nonFilteredFileExtensionzip/nonFilteredFileExtension /nonFilteredFileExtensions /configuration /plugin同时配置maven-jar-plugin排除非必要资源plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-jar-plugin/artifactId configuration excludes exclude**/*.properties/exclude exclude**/*.xml/exclude excludestatic/images/**/exclude /excludes /configuration /plugin3.3 第三步优化构建过程并行构建配置settings pluginGroups pluginGrouporg.apache.maven.plugins/pluginGroup /pluginGroups profiles profile idfast-build/id properties maven.test.skiptrue/maven.test.skip maven.compile.forktrue/maven.compile.fork maven.compiler.useIncrementalCompilationfalse/maven.compiler.useIncrementalCompilation /properties /profile /profiles activeProfiles activeProfilefast-build/activeProfile /activeProfiles /settings增量编译技巧# 只编译变更的模块 mvn compile -pl moduleA -am # 跳过测试 mvn package -DskipTests # 使用构建缓存Maven 3.6 mvn package -Dmaven.build.cache.enabledtrue4. 进阶优化方案4.1 依赖分类管理采用BOM统一版本dependencyManagement dependencies dependency groupIdorg.springframework.cloud/groupId artifactIdspring-cloud-dependencies/artifactId version2021.0.3/version typepom/type scopeimport/scope /dependency /dependencies /dependencyManagement4.2 模块化拆分对于大型单体项目parent-project ├── core-module (基础工具) ├── service-module (业务实现) └── web-module (接口层)每个子模块有独立的pom.xml通过dependency的scopecompile/runtime/scope控制依赖传递4.3 使用JLink定制JRE对于JDK9项目jlink --module-path $JAVA_HOME/jmods:target/modules \ --add-modules com.your.module \ --output target/custom-jre \ --strip-debug \ --compress2 \ --no-header-files \ --no-man-pages可将运行时环境从200MB缩减到40MB左右5. 效果验证与监控5.1 构建指标对比优化前后数据示例指标优化前优化后构建时间5分12秒2分38秒最终jar大小120MB38MB依赖项数量147个62个编译占用内存峰值2.1GB1.3GB5.2 持续监控方案在Jenkinsfile中添加构建监控pipeline { post { always { recordIssues( tools: [mavenConsole()] ) archiveArtifacts artifacts: **/target/*.jar, allowEmptyArchive: true perfReport sourceDataFiles: **/build.log } } }6. 避坑指南不要过度排除曾有一个团队排除了spring-boot-starter-logging导致SLF4J无实现报错注意可选依赖如JPA实现可能动态选择Hibernate/EclipseLink多环境验证某次优化后本地运行正常但缺少AWS SDK导致生产环境报错版本冲突优先级遵循Maven的最近定义原则nearest definition wins血泪教训有一次清理了看似无用的commons-collections结果导致报表模块的POI导出功能崩溃。建议在清理前后运行完整的集成测试套件7. 配套工具推荐JDeps分析类级别的依赖关系jdeps --multi-release 11 -R your-app.jarClassgraph运行时扫描实际用到的类try (ScanResult scan new ClassGraph().enableAllInfo().scan()) { scan.getAllClasses().stream() .map(ClassInfo::getName) .forEach(System.out::println); }Maven Enforcer插件强制依赖约束plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-enforcer-plugin/artifactId executions execution idenforce/id goalsgoalenforce/goal/goals configuration rules banDuplicateClasses ignoreClasses ignoreClassorg.slf4j.*/ignoreClass /ignoreClasses /banDuplicateClasses /rules /configuration /execution /executions /plugin8. 真实案例复盘某电商平台优化实录初始状态打包时间8分钟jar包210MB发现问题同时引入了log4j和logback包含完整的Spring Cloud Config客户端但未使用静态资源未压缩优化措施统一日志框架为logback移除未使用的Cloud组件启用Gzip压缩资源最终效果打包时间降至2分钟jar包大小89MB关键收获通过mvn dependency:analyze-dep-mgt发现父pom中过期的依赖管理声明才是真正的元凶
