快捷導(dǎo)航

利用maven-shade-plugin插件解決不兼容的依賴沖突的情況

更新時(shí)間：2026年05月17日 10:39:52 作者：菜鳥呼叫總部

本文介紹了在Maven工程中遇到底層依賴包版本沖突問題,使用maven-shade-plugin插件解決沖突的方法,并詳細(xì)描述了步驟及注意事項(xiàng)

使用場景的介紹

1.在maven工程中，我們常常遇到底層依賴包的版本沖突問題。如果高版本對低版本兼容，那么我們可以使用maven的exclusions排除掉低版本。但如果版本互不兼容，甚至是不同jar有相同類名的沖突，就比較棘手了。

2.例如我這個(gè)項(xiàng)目的epoint-sso-authenticator 依賴了一個(gè)低版本的bcprov-jdk15on，hutool的依賴了一個(gè)高版本的，里面有包名類名都重復(fù)的類，況且高版本不兼容低版本，二者都保留，必然會(huì)有一個(gè)功能報(bào)錯(cuò)，排除其中任何一個(gè)，對應(yīng)的功能也會(huì)報(bào)錯(cuò)。

3.此時(shí)可以使用maven-shade-plugin，重新打一個(gè)新的jar包，將bcprov-jdk15on包名重置，并自動(dòng)更改Hutool包中對bcprov-jdk15on包的import路徑。

整合步驟

1、新建一個(gè)空的maven工程shaded-hutool，pom依賴如下；

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.example</groupId>
  <artifactId>shaded-hutool</artifactId>
  <version>1.0</version>
  <packaging>jar</packaging>
  <name>shaded-hutool</name>
  <url>http://maven.apache.org</url>
  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  </properties>
  <dependencies>
    <dependency>
      <groupId>cn.hutool</groupId>
      <artifactId>hutool-all</artifactId>
      <version>5.5.7</version>
    </dependency>
    <dependency>
      <groupId>org.bouncycastle</groupId>
      <artifactId>bcprov-jdk15on</artifactId>
      <version>1.67-e1</version>
    </dependency>
  </dependencies>
  <build>
    <plugins>
      <!-- 指定項(xiàng)目java編譯版本 -->
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <configuration>
          <source>1.8</source>
          <target>1.8</target>
        </configuration>
      </plugin>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-shade-plugin</artifactId>
        <version>3.2.4</version>
        <executions>
          <execution>
            <phase>package</phase>
            <goals>
              <goal>shade</goal>
            </goals>
            <configuration>
              <createDependencyReducedPom>true</createDependencyReducedPom>
              <relocations>
                <relocation>
                  <pattern>org.bouncycastle</pattern>
                  <shadedPattern>shaded.org.bouncycastle</shadedPattern>
                </relocation>
              </relocations>
              <filters>
                <filter>
                  <artifact>*:*</artifact>
                  <excludes>
                    <exclude>META-INF/*.SF</exclude>
                    <exclude>META-INF/*.DSA</exclude>
                    <exclude>META-INF/*.RSA</exclude>
                  </excludes>
                </filter>
              </filters>
            </configuration>
          </execution>
        </executions>
      </plugin>
    </plugins>
  </build>
</project>

這里就是把hutool里關(guān)于引入的org.bouncycastle的類，統(tǒng)一修改成了shaded.org.bouncycastle，這樣即使類名重復(fù)，包名也不會(huì)重復(fù)，不會(huì)產(chǎn)生沖突了。

2、新建的工程打包，解壓后,發(fā)現(xiàn)把bcprov-jdk15on也給編譯進(jìn)去了，并且自動(dòng)加了一個(gè)層級(jí)shaded。