依赖版本冲突解决

多路径引入同一依赖不同版本时，Maven 自动选择版本。

冲突产生场景

多路径同一依赖

项目 → A → B → commons-lang:2.0
项目 → C → commons-lang:3.0

问题：commons-lang 有两个版本

冲突表现

Maven 解决策略

最短路径优先

路径1：项目 → A → B → commons-lang:2.0  （深度3）
路径2：项目 → C → commons-lang:3.0     （深度2）

选择：commons-lang:3.0（路径更短）

声明顺序优先

路径深度相同时：

pom.xml 中先声明 A → commons-lang:2.0
pom.xml 中后声明 B → commons-lang:3.0

选择：commons-lang:2.0（先声明）

诊断依赖冲突

使用 dependency:tree

mvn dependency:tree

查看依赖冲突详情

mvn dependency:tree -Dverbose

输出示例：

[INFO] +- commons-lang:commons-lang:jar:3.0:compile
[INFO] +- A:jar:1.0:compile
[INFO] |  \- commons-lang:commons-lang:jar:2.0:compile (omitted for conflict: 3.0)

使用 dependency:analyze

mvn dependency:analyze

输出未使用和缺失依赖：

[WARNING] Used undeclared dependencies:
[WARNING]   commons-lang:commons-lang:jar:3.0
[WARNING] Unused declared dependencies:
[WARNING]   log4j:log4j:jar:1.2.17

手动解决冲突

方式1：声明优先版本

<!-- 在项目直接声明需要的版本 -->
<dependency>
  <groupId>commons-lang</groupId>
  <artifactId>commons-lang</artifactId>
  <version>3.0</version>
</dependency>

直接声明优先级最高，覆盖传递依赖。

方式2：排除冲突版本

<dependency>
  <groupId>com.example</groupId>
  <artifactId>module-a</artifactId>
  <version>1.0.0</version>
  <exclusions>
    <exclusion>
      <groupId>commons-lang</groupId>
      <artifactId>commons-lang</artifactId>
    </exclusion>
  </exclusions>
</dependency>

方式3：dependencyManagement

<dependencyManagement>
  <dependencies>
    <!-- 统一版本 -->
    <dependency>
      <groupId>commons-lang</groupId>
      <artifactId>commons-lang</artifactId>
      <version>3.0</version>
    </dependency>
  </dependencies>
</dependencyManagement>

优先级规则汇总

冲突解决最佳实践

推荐做法

实例配置

<properties>
  <commons-lang.version>3.0</commons-lang.version>
</properties>

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>commons-lang</groupId>
      <artifactId>commons-lang</artifactId>
      <version>${commons-lang.version}</version>
    </dependency>
  </dependencies>
</dependencyManagement>

常见冲突案例

log4j vs logback

<!-- 排除 log4j -->
<dependency>
  <groupId>org.springframework</groupId>
  <artifactId>spring-core</artifactId>
  <exclusions>
    <exclusion>
      <groupId>log4j</groupId>
      <artifactId>log4j</artifactId>
    </exclusion>
  </exclusions>
</dependency>

<!-- 使用 logback -->
<dependency>
  <groupId>ch.qos.logback</groupId>
  <artifactId>logback-classic</artifactId>
  <version>1.2.11</version>
</dependency>

要点总结

• 最短路径优先：依赖层级少的版本优先
• 声明顺序优先：同深度时先声明优先
• 项目直接声明版本优先级最高
• 使用 dependency:tree -Dverbose 诊断冲突
• dependencyManagement 统一版本管理