多模块项目中如何用Maven排除依赖？完整解决方案

以下是关于 Maven 打包过程中排除特定依赖的完整指南，涵盖不同场景下的排除方法、配置技巧和常见问题解决方案：

1. 基础排除：在依赖声明中直接排除

场景：当引入一个依赖时，需要排除它传递性引入的某个依赖。

配置示例：

<dependency>
    <groupId>com.example</groupId>
    <artifactId>example-library</artifactId>
    <version>1.0.0</version>
    <exclusions>
        <!-- 排除传递性依赖 -->
        <exclusion>
            <groupId>org.unwanted</groupId>
            <artifactId>unwanted-dependency</artifactId>
        </exclusion>
    </exclusions>
</dependency>

关键点：

<exclusions> 可以包含多个 <exclusion>。
排除的是依赖的 groupId 和 artifactId，不需要指定版本（版本由被排除的依赖管理决定）。

2. 全局排除：在 `<dependencyManagement>` 中统一管理

场景：多个模块都需要排除同一个依赖时，避免重复配置。

配置示例：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.example</groupId>
            <artifactId>example-library</artifactId>
            <version>1.0.0</version>
            <exclusions>
                <exclusion>
                    <groupId>org.unwanted</groupId>
                    <artifactId>unwanted-dependency</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
    </dependencies>
</dependencyManagement>

<!-- 子模块中直接引用，无需重复排除 -->
<dependency>
    <groupId>com.example</groupId>
    <artifactId>example-library</artifactId>
</dependency>

3. 插件依赖排除

场景：Maven 插件引入的依赖需要排除（如 `maven-shade-plugin` 或 `maven-assembly-plugin`）。

配置示例：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.5.0</version>
    <dependencies>
        <dependency>
            <groupId>org.unwanted</groupId>
            <artifactId>unwanted-plugin-dependency</artifactId>
            <version>1.0.0</version>
            <exclusions>
                <exclusion>
                    <groupId>org.conflict</groupId>
                    <artifactId>conflict-dependency</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
    </dependencies>
</plugin>

4. 使用 `<dependencyManagement>` 强制覆盖版本

场景：排除依赖后，可能需要显式引入一个兼容版本。

配置示例：

<dependencyManagement>
    <dependencies>
        <!-- 强制指定版本 -->
        <dependency>
            <groupId>org.unwanted</groupId>
            <artifactId>unwanted-dependency</artifactId>
            <version>2.0.0</version> <!-- 覆盖被排除的版本 -->
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>
    <dependency>
        <groupId>com.example</groupId>
        <artifactId>example-library</artifactId>
        <version>1.0.0</version>
        <exclusions>
            <exclusion>
                <groupId>org.unwanted</groupId>
                <artifactId>unwanted-dependency</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
    <!-- 显式引入新版本 -->
    <dependency>
        <groupId>org.unwanted</groupId>
        <artifactId>unwanted-dependency</artifactId>
    </dependency>
</dependencies>

5. 排除测试依赖

场景：排除测试范围（`test` scope）的依赖传递。

配置示例：

<dependency>
    <groupId>com.example</groupId>
    <artifactId>example-library</artifactId>
    <version>1.0.0</version>
    <scope>compile</scope> <!-- 确保主代码依赖 -->
    <exclusions>
        <exclusion>
            <groupId>org.test</groupId>
            <artifactId>test-dependency</artifactId>
        </exclusion>
    </exclusions>
</dependency>

6. 使用 `maven-dependency-plugin` 分析依赖树

步骤：

查看依赖树，定位需要排除的依赖：

   mvn dependency:tree -Dverbose

-Dverbose 会显示被忽略的依赖（如被其他依赖覆盖的版本）。

生成依赖报告：

   mvn dependency:analyze

7. 高级场景：排除并替换为本地 JAR

场景：排除某个依赖后，使用本地或私有仓库的版本。

配置示例：

<dependency>
    <groupId>com.example</groupId>
    <artifactId>example-library</artifactId>
    <version>1.0.0</version>
    <exclusions>
        <exclusion>
            <groupId>org.unwanted</groupId>
            <artifactId>unwanted-dependency</artifactId>
        </exclusion>
    </exclusions>
</dependency>

<!-- 显式引入本地 JAR -->
<dependency>
    <groupId>org.unwanted</groupId>
    <artifactId>unwanted-dependency</artifactId>
    <version>2.0.0</version>
    <scope>system</scope>
    <systemPath>${project.basedir}/lib/unwanted-dependency-2.0.0.jar</systemPath>
</dependency>