Maven 中怎么使用 shade 插件打包并重命名第三方包防止冲突

风芳吖_4931

风芳吖_4931

2026-08-10

950人浏览

原创

使用maven-shade-plugin的功能可重命名冲突依赖包路径,如将org.bouncycastle.改为com.yourcompany.shaded.bc.,新建shading模块单独处理、限定子包范围、验证类路径变更后,主项目直接引入shaded包即可隔离类冲突。

maven 中怎么使用 shade 插件打包并重命名第三方包防止冲突

直接用 maven-shade-plugin 的 功能,就能在打包时把第三方包的路径整体改掉,让冲突类“各过各的”,不抢同一个类名空间。

先确认到底哪里冲突了

别一上来就配插件。先搞清是哪个包、哪几个类在打架:

  • 运行 mvn dependency:tree | grep -A 3 -B 3 "bcprov\|jackson\|kafka",看哪些依赖拉进了同名 artifact(比如两个不同版本的 bcprov-jdk15on)
  • 查报错堆栈,找到具体加载失败的类全名,例如 org.bouncycastle.crypto.params.RSAKeyParameters
  • 用 jar -tf 或反编译工具打开两个 jar,确认它们真有相同包+相同类,不是只是名字像

新建一个 shading 模块来单独处理

不要在主项目里直接 shade 全局依赖——容易误伤。推荐另建一个空 Maven 模块(如 shaded-bcprov),只负责重命名那个冲突依赖:

Java 接口排错助手
Java 接口排错助手

在调试 Java 后端 API 故障时使用此技能,尤其适用于以下任务:分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转,以及生成简洁的诊断结论与修复方案。

下载
  • pom 中只声明要被重命名的那个依赖,比如 bcprov-jdk15on:1.70
  • 配置 maven-shade-plugin,重点写 块
  • 指定原始包名前缀(org.bouncycastle.)和新前缀(com.yourcompany.shaded.bc.)
  • 可加 限定只重命名 crypto.* 或 asn1.* 这些实际用到的子包,避免把测试类或无关工具类也挪走

打包后验证是否生效

执行 mvn clean package 后,检查生成的 jar 是否真的“变脸”成功:

  • 用 jar -tf target/shaded-bcprov-1.0.jar | grep "shaded.bc" 确认类路径已更新
  • 解压 jar 查看 com/yourcompany/shaded/bc/crypto/params/RSAKeyParameters.class 是否存在
  • 如果这个 jar 是给 Hutool 这类库用的,插件会自动把 Hutool 编译后的字节码中对 org.bouncycastle.crypto.* 的引用,全部替换成新路径——不用改一行源码
  • 把新 jar 作为普通依赖引入主项目,原冲突依赖(比如低版本 bcprov)仍保留,不再 exclude

主项目里怎么用这个 shaded 包

主项目的 pom 中这样写就行:

  • 保留原有冲突依赖(如旧版 bcprov-jdk15on),不 exclude
  • 显式添加你刚打好的 shaded 包:com.yourcompanyshaded-bcprov
  • 确保 shaded 包的 scope 是 compile(默认),让它参与编译和运行时类加载
  • 运行时,JVM 加载 com.yourcompany.shaded.bc.crypto.* 和 org.bouncycastle.crypto.* 是完全独立的两套,互不影响

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

java maven

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Java Maven专题
Java Maven专题

本专题聚焦 Java 主流构建工具 Maven 的学习与应用,系统讲解项目结构、依赖管理、插件使用、生命周期与多模块项目配置。通过企业管理系统、Web 应用与微服务项目实战,帮助学员全面掌握 Maven 在 Java 项目构建与团队协作中的核心技能。

2025.09.15

4220

19

Java Maven/Gradle 构建与依赖管理合集
Java Maven/Gradle 构建与依赖管理合集

系统讲解 Java 项目构建工具的使用与进阶配置,涵盖 Maven 的 POM 文件结构、生命周期(clean/compile/package/install/deploy)与插件机制、依赖范围(compile/provided/test/runtime)与传递依赖管理、多模块聚合与继承、私有 Nexus 仓库发布,以及 Gradle 的 Groovy / Kotlin DSL 语法、Task 自定义与增量构建、依赖版本目录(Versi

2026.05.09

389

25

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

2026.10.28

60

16

Vite 如何搭配 Vue.js
Vite 如何搭配 Vue.js

Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章,帮助读者完成从初始化到日常开发的配置。

2026.10.28

40

15

Vite 项目目录怎么看
Vite 项目目录怎么看

Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章,帮助读者理解各文件夹的用途与引用方式。

2026.10.28

140

10

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

2026.10.22

140

11

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。

2026.10.22

120

10

Golangci-lint检查器使用教程
Golangci-lint检查器使用教程

本专题整理Golangci-lint常用Linters的用途与配置方法,覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查,帮助项目合理选规则。

2026.10.22

80

15

Gradle怎么构建Java项目
Gradle怎么构建Java项目

本专题介绍Gradle Java项目构建方法,涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查,帮助你理解各阶段的任务关系,逐步完成项目构建。

2026.10.22

40

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习