依赖版本冲突怎么办？手把手教你快速定位和解决

写代码时突然报错：「找不到类」「方法不存在」「NoSuchMethodError」……重启、重装、清缓存全试了，还是不行？十有八九是依赖版本冲突在作怪。

啥叫依赖版本冲突？

打个比方：你项目里同时引入了 A 库（v1.2）和 B 库（v2.5），而它们俩都偷偷打包了同一个底层工具库 C——但 A 要的是 C v3.0，B 却绑定了 C v4.1。JVM 或构建工具最后只加载了一个 C 版本（比如 v4.1），结果 A 一调用 C 里已被删掉的老方法，立马崩给你看。

怎么一眼揪出谁在捣鬼？

Maven 项目直接终端敲：

mvn dependency:tree -Dincludes=commons-collections

把 commons-collections 换成你怀疑的库名就行。输出里如果同一库出现多个版本，前面带星号（★）或缩进混乱的，基本就是冲突源头。

Gradle 用户试试：

./gradlew app:dependencies --configuration compileClasspath | grep 'gson'

同样替换为你要查的库名，比如 gson、okhttp 等。

常见解法，按场景选一个就行

① 强制指定统一版本（最常用）
在 Maven 的 pom.xml 的 <dependencyManagement> 块里加：

<dependency>
  <groupId>com.google.code.gson</groupId>
  <artifactId>:gson</artifactId>
  <version>2.10.1</version>
</dependency>

这样所有子模块哪怕声明了旧版，也会被自动升级/降级到 2.10.1。

② 排除捣乱的传递依赖
比如发现某个第三方 SDK 带来了过时的 slf4j-api，直接干掉它：

<dependency>
  <groupId>com.example</groupId>
  <artifactId>legacy-sdk</artifactId>
  <exclusions>
    <exclusion>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-api</artifactId>
    </exclusion>
  </exclusions>
</dependency>

③ IDE 里点一点也能搞定
IntelliJ：打开 Maven 工具窗 → 右键项目 → Reload project，再双击左侧依赖树里的冲突项，右边会显示所有引用路径，鼠标悬停就能看到哪个依赖带进来、版本多少，右键可直接 Exclude。

小提醒

别盲目升级所有依赖。有些老系统用 Spring Boot 2.3，硬升到 3.x 会直接不兼容；Android 开发里 Retrofit 和 OkHttp 版本还得互相匹配。先查文档，再动手。本地跑通了，记得推到测试环境再验一遍——有时候冲突只在特定机型或 JDK 版本下才露头。

遇到报错别急着百度全文，先看堆栈最上面几行，找第一个你项目里没写的类名，顺着它往上查依赖来源，往往五分钟就破案。