一、检测依赖冲突的方法

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  
[INFO] \- org.lib:bar:jar:2.0:compile
[INFO]    \- org.lib:common:jar:2.0:compile  

• 过滤特定依赖：

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 文件中先声明的依赖的版本。
• 示例：

      
        org.lib
        foo
        1.0  
    
      
        org.lib
        bar
        2.0  
    

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

三、如何强制指定版本？

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

1.在中锁定版本

    
        
            org.lib
            common
            2.0  
        
    

2.排除冲突依赖（Exclusions）

    org.lib
    foo
    1.0
    
        
            org.lib
            common
        
    

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

    org.lib
    common
    2.0

四、验证最终生效版本

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

mvn dependency:list -DincludeArtifactIds=common

输出示例：

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