1. Maven Shade Plugin 深度解析第一次接触maven-shade-plugin是在2015年做微服务迁移时当时被各种依赖冲突折磨得够呛。这个插件就像个瑞士军刀能解决很多打包时的棘手问题。简单来说它能把你的项目代码和所有依赖库打包成一个胖JARfat JAR这样部署时只需要一个文件就能运行特别适合需要独立运行的命令行工具或微服务应用。与普通打包方式不同shade插件会深度处理依赖关系。我遇到过最典型的问题是两个依赖库都引入了不同版本的Guava运行时随机报NoSuchMethodError。用shade插件重命名其中一个库的包路径问题就迎刃而解了。它的核心能力包括依赖合并与冲突解决资源文件智能处理包路径重定向清单文件(Manifest)定制实际项目中我推荐在以下场景使用需要生成可执行JAR的命令行工具依赖复杂容易冲突的微服务应用需要分发的SDK或库文件包含第三方依赖的Spark作业2. 高级配置实战技巧2.1 依赖冲突的终极解决方案去年给某金融客户做系统升级时遇到个经典案例他们的交易系统同时依赖了hadoop-common 2.7和hbase-client 1.4这两个库又分别依赖了不同版本的protobuf。直接运行会报序列化错误这时候relocation配置就派上用场了relocations relocation patterncom.google.protobuf/pattern shadedPatterncom.company.shaded.protobuf/shadedPattern /relocation /relocations这个配置会把所有protobuf类文件移动到新包路径下相当于创建了项目私有的protobuf版本。有几点实战经验值得注意重命名范围要精确到具体冲突的包不要无脑重命名所有依赖测试阶段要特别检查动态加载的类比如通过Class.forName加载的配合mvn dependency:tree分析依赖树更高效2.2 资源合并的黑科技Spring Boot项目里最让人头疼的就是各种META-INF/spring.factories文件冲突。我常用的解决方案是transformers transformer implementationorg.apache.maven.plugins.shade.resource.AppendingTransformer resourceMETA-INF/spring.factories/resource /transformer transformer implementationorg.apache.maven.plugins.shade.resource.ServicesResourceTransformer/ /transformers这里用了两个特殊处理器AppendingTransformer合并文件内容而不是覆盖ServicesResourceTransformer专门处理ServiceLoader机制需要的META-INF/services/资源最近还发现个隐藏技巧可以用标签选择性打包资源。比如只想保留某个库的特定配置文件filters filter artifactcom.some.library:*/artifact includes include**/important-config.xml/include /includes /filter /filters3. 性能调优实战3.1 加速构建的五个诀窍大型项目用shade插件打包可能会很慢我总结了几条提速经验最小化重命名范围只relocate确实存在冲突的包并行构建配置configuration shadedArtifactAttachedtrue/shadedArtifactAttached shadedClassifierNameshaded/shadedClassifierName createDependencyReducedPomfalse/createDependencyReducedPom /configuration使用本地仓库缓存定期执行mvn dependency:purge-local-repository排除测试依赖在中加上/test/分模块构建把重依赖的模块单独打包3.2 瘦身秘籍胖JAR体积过大是个通病去年优化过一个从180MB减到45MB的案例用dependency:analyze找出无用依赖排除重复依赖filters filter artifact*:*/artifact excludes excludeMETA-INF/LICENSE/exclude excludeMETA-INF/*.txt/exclude /excludes /filter /filters按环境打包不同配置profiles profile idprod/id build plugins plugin configuration excludes exclude**/dev.properties/exclude /excludes /configuration /plugin /plugins /build /profile /profiles4. 企业级应用方案4.1 安全加固配置金融行业项目对安全要求严格这是我的标准安全配置模板configuration filters filter artifact*:*/artifact excludes exclude**/*.p12/exclude exclude**/*.keystore/exclude excludeMETA-INF/maven/**/exclude /excludes /filter /filters transformers transformer implementationorg.apache.maven.plugins.shade.resource.ManifestResourceTransformer mainClasscom.company.secure.Main/mainClass manifestEntries Implementation-Version${project.version}/Implementation-Version Sealedtrue/Sealed /manifestEntries /transformer /transformers /configuration关键点排除所有证书文件运行时通过外部配置加载移除Maven元数据防止信息泄露设置Sealedtrue增强包密封性使用确定的版本号而非SNAPSHOT4.2 多环境打包策略为不同环境生成定制化包是个常见需求我的方案是定义环境变量过滤器filters filter artifact*:*/artifact excludes exclude**/application-${env}.yml/exclude /excludes /filter /filters配合资源过滤插件resources resource directorysrc/main/resources/directory filteringtrue/filtering includes include**/application.yml/include /includes /resource /resources使用profile激活不同配置mvn package -Pprod -Denvprod5. 疑难杂症排查指南5.1 常见错误与解决方案踩坑多年我整理了几个典型问题问题1NoSuchMethodError但类明明存在原因依赖冲突导致方法签名不一致解决方案用relocation隔离冲突库问题2Spring自动配置不生效原因META-INF/spring.factories被覆盖解决方案添加AppendingTransformer问题3JAR运行时报签名错误解决方案过滤签名文件excludes excludeMETA-INF/*.SF/exclude excludeMETA-INF/*.DSA/exclude excludeMETA-INF/*.RSA/exclude /excludes5.2 调试技巧当打包结果不符合预期时我的排查流程是检查原始依赖mvn dependency:tree -Dverbose tree.txt解压生成的胖JARjar xvf target/*-shaded.jar使用字节码查看工具检查类文件来源开启插件调试日志configuration debugtrue/debug verbosetrue/verbose /configuration最近还发现个实用技巧可以用mvn help:effective-pom查看最终生效的插件配置特别适合排查profile覆盖问题。