依赖冲突如何排查

排查依赖冲突的核心思路是：先定位冲突来源 → 再分析冲突原因 → 最后选择合适的解决方式。下面按常见场景给你一套可操作的排查方法。

一、常见依赖冲突表现

• 启动时报错：NoSuchMethodError、ClassNotFoundException、Method not found
• 编译通过，运行时异常
• 同一个 Jar 被加载了多个版本
• 某个功能在不同环境表现不一致

二、快速定位冲突（通用思路）

1️⃣ 找到“谁引入了冲突依赖”

Maven

mvn dependency:tree

查看某个依赖：

mvn dependency:tree -Dincludes=com.google.guava

Gradle

./gradlew dependencies

2️⃣ 判断是否存在多个版本

重点看：

• 同一个 groupId + artifactId，但 version 不同
• 不同 groupId，但包名/类名相同

例如：

com.google.guava:guava:30.1-jre
com.google.guava:guava:31.1-jre

三、常见冲突原因

✅ 1. 传递依赖冲突（最常见）

A 依赖 guava 30 B 依赖 guava 31 最终只保留一个版本，可能不兼容。

✅ 2. 依赖被覆盖（Dependency Override）

• Maven 的 dependencyManagement
• Gradle 的 force、resolutionStrategy

✅ 3. 包名相同但来源不同

例如：

• javax.annotation vs jakarta.annotation
• slf4j vs logback-classic

✅ 4. 运行时加载顺序问题

• classpath 顺序
• 多个 classloader（插件、容器、热部署）

四、如何确认“到底用了哪个版本”

Maven

mvn dependency:analyze
mvn dependency:resolve

Gradle

./gradlew dependencyInsight --dependency guava

五、解决依赖冲突的常用方案

✅ 方案 1：统一版本（推荐）

Maven

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.guava</groupId>
      <artifactId>guava</artifactId>
      <version>31.1-jre</version>
    </dependency>
  </dependencies>
</dependencyManagement>

Gradle

configurations.all {
    resolutionStrategy {
        force 'com.google.guava:guava:31.1-jre'
    }
}

✅ 方案 2：排除冲突依赖

Maven

<dependency>
  <groupId>xxx</groupId>
  <artifactId>xxx</artifactId>
  <exclusions>
    <exclusion>
      <groupId>com.google.guava</groupId>
      <artifactId>guava</artifactId>
    </exclusion>
  </exclusions>
</dependency>

Gradle

implementation('xxx:xxx:1.0') {
    exclude group: 'com.google.guava'
}

✅ 方案 3：升级或降级依赖

• 升级旧依赖
• 降级新依赖
• 使用兼容版本矩阵

✅ 方案 4：使用工具辅助分析

• Maven Helper（IDEA 插件）（强烈推荐）
• Gradle Dependency Analyzer
• jdeps、jar tf 查看类

六、排查流程总结（实战版）

一句话流程：

看报错 → 找类 → 查依赖树 → 看版本 → 统一或排除

1. 从异常栈找到冲突的类
2. 用 dependency:tree 找引入来源
3. 确认加载了哪个版本
4. 决定：统一版本 / 排除 / 升级

七、如果你愿意，我可以进一步帮你

你可以直接贴：

• 报错信息
• dependency:tree 输出
• 使用的构建工具（Maven / Gradle）
• 冲突的库名

我可以帮你精确定位并给出最优解决方案。