一、检测依赖冲突的方法

1.使用mvn dependency:tree命令

mvn dependency:tree

• 作用：以树形结构显示所有依赖（包括直接依赖和间接依赖），标记冲突版本。
• 示例输出：

[INFO] com.example:demo:jar:1.0
[INFO] +- org.lib:foo:jar:1.0:compile
[INFO] |  \- org.lib:common:jar:1.0:compile  <!-- 冲突版本 1.0 -->
[INFO] \- org.lib:bar:jar:2.0:compile
[INFO]    \- org.lib:common:jar:2.0:compile  <!-- 冲突版本 2.0 -->

• 过滤特定依赖：

mvn dependency:tree -Dincludes=org.lib:common

2.使用 IDE 插件

• IntelliJ IDEA：右键项目 → Maven → Show Dependencies，图形化显示冲突（红色高亮）。

3.使用mvn dependency:analyze

mvn dependency:analyze

• 检测未使用的依赖（Unused Declared Dependencies）和冲突警告。

二、Maven 的依赖调解（Dependency Mediation）规则

当同一依赖有多个版本（如 1.0 和 2.0）时，Maven 按以下优先级选择版本：

1.最短路径优先（Nearest Definition Wins）

• 选择依赖树中路径最短的版本。
• 示例：

A
├── B ─── C ─── D 1.0
└── E ─── D 2.0

• 项目 A 会选择 D 2.0（路径 A→E→D 比 A→B→C→D 更短）。

2.最先声明优先（First Declaration Wins）

• 如果路径长度相同，则选择 POM 文件中先声明的依赖的版本。
• 示例：

<dependencies>
    <dependency>  <!-- 先声明 -->
        <groupId>org.lib</groupId>
        <artifactId>foo</artifactId>
        <version>1.0</version>  <!-- 引入 common 1.0 -->
    </dependency>
    <dependency>  <!-- 后声明 -->
        <groupId>org.lib</groupId>
        <artifactId>bar</artifactId>
        <version>2.0</version>  <!-- 引入 common 2.0 -->
    </dependency>
</dependencies>

• 最终选择 common 1.0（因为 foo 先声明）。

三、如何强制指定版本？

如果自动调解结果不符合预期，可通过以下方式显式指定版本：

1.在<dependencyManagement>中锁定版本

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.lib</groupId>
            <artifactId>common</artifactId>
            <version>2.0</version>  <!-- 强制指定版本 -->
        </dependency>
    </dependencies>
</dependencyManagement>

2.排除冲突依赖（Exclusions）

<dependency>
    <groupId>org.lib</groupId>
    <artifactId>foo</artifactId>
    <version>1.0</version>
    <exclusions>
        <exclusion>
            <groupId>org.lib</groupId>
            <artifactId>common</artifactId>
        </exclusion>
    </exclusions>
</dependency>

3.直接添加正确版本的依赖

<dependency>
    <groupId>org.lib</groupId>
    <artifactId>common</artifactId>
    <version>2.0</version>
</dependency>

四、验证最终生效版本

运行以下命令查看实际引入的版本：

mvn dependency:list -DincludeArtifactIds=common

输出示例：

[INFO] org.lib:common:jar:2.0:compile