使用maven-shade-plugin解決maven依賴衝突

場景

項目裏面需要用到華爲雲的mpc sdk，所以就加入了該sdk的依賴，運行的時候報ClassNotFound異常，經過查看源碼後發現是缺失了JsonReadFeature這個類； 然後經過排查，發現當前項目中的jackson版本爲2.9.8，mpc sdk依賴的jackson版本爲2.14.2，JsonReadFeature類存在於2.14.2版本中，低版本的2.9.8中沒有；總結下，很典型的因同一個依賴版本不同導致衝突的場景。

解決方案

使用maven-shade-plugin重新打包mpc sdk

解決步驟

1.新建一個項目，名稱爲shade-mpc-sdk

2.增加配置如下（部分敏感信息，已做脫敏處理），重點看依賴項及maven-shade-plugin的配置

<?xml version="1.0" encoding="UTF-8"?>
<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.xxx</groupId>
    <artifactId>shade-huaweicloud-sdk-mpc</artifactId>
    <version>3.1.45</version>

    <properties>
        <huaweicloud-sdk-mpc.version>3.1.45</huaweicloud-sdk-mpc.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>com.huaweicloud.sdk</groupId>
            <artifactId>huaweicloud-sdk-mpc</artifactId>
            <version>${huaweicloud-sdk-mpc.version}</version>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-shade-plugin</artifactId>
                <version>3.4.1</version>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>shade</goal>
                        </goals>
                        <configuration>
                            <createDependencyReducedPom>false</createDependencyReducedPom>
                            <filters>
                                <filter>
                                    <artifact>*:*</artifact>
                                    <!--
                                    在使用maven-shade-plugin時，排除META-INF/*.SF、META-INF/*.DSA和META-INF/*.RSA文件
                                    是爲了避免在構建過程中出現安全問題。這些文件是Java的簽名文件，它們包含了用於驗證jar包完整性和來源的數字簽名信息。
                                    當多個jar包被合併成一個jar包時，這些簽名文件可能會發生衝突/重複，導致校驗不通過。
                                    -->
                                    <excludes>
                                        <exclude>META-INF/*.SF</exclude>
                                        <exclude>META-INF/*.DSA</exclude>
                                        <exclude>META-INF/*.RSA</exclude>
                                    </excludes>
                                </filter>
                            </filters>
                            <relocations>
                                <relocation>
                                    <pattern>com.fasterxml.jackson</pattern>
                                    <shadedPattern>shade.fasterxml.jackson</shadedPattern>
                                </relocation>
                            </relocations>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

</project>

3.重新package、install

4.在原項目中將mpc sdk的依賴座標改爲剛install的jar的座標

解決原理

根據我的插件配置，maven-shade-plugin會將com.fasterxml.jackson重命名爲shade.fasterxml.jackson，並把該路徑下的所有的類打進當前jar中；同時也會修改當前項目中及其它依賴的jar中的import路徑