Maven依赖冲突怎么解决？Jar包冲突排查指南

Maven依赖冲突怎么解决？Jar包冲突排查指南

项目跑着好好的，突然就报错了：

NoSuchMethodError ClassNotFoundException

别慌，十有八九是Maven依赖冲突。今天教你怎么排查和解决。

为什么会冲突？

假设你的项目同时依赖了A和B两个库：

项目依赖 A 项目依赖 B A 依赖 Guava 30.0 B 依赖 Guava 31.0

Maven只会选一个版本的Guava，但A和B各自需要的版本不同，就可能出问题。

常见报错

NoSuchMethodError：

java.lang.NoSuchMethodError: com.google.common.xxx

原因：运行时加载的类版本和编译时不一致，某个方法在低版本里没有。

ClassNotFoundException：

java.lang.ClassNotFoundException: org.apache.xxx

原因：依赖被排除了或者根本没引入。

排查方法

第一步：查看依赖树

mvn dependency:tree

会显示项目所有依赖的层级关系。

第二步：搜索特定依赖

依赖树太长看不过来，可以过滤：

# 只看guava相关mvn dependency:tree -Dincludes=com.google.guava

第三步：看冲突详情

mvn dependency:tree -Dverbose

会显示被省略的依赖：

+- com.example:lib-a:jar:1.0 | \- com.google.guava:guava:jar:30.0 (被选中) \- com.example:lib-b:jar:2.0 \- (com.google.guava:guava:jar:31.0 - 被省略，和30.0冲突)

这样就能看出谁引入了哪个版本。

解决方法

方法1：排除依赖

让A不要带着它的Guava：

<dependency><groupId>com.example</groupId><artifactId>lib-a</artifactId><version>1.0</version><exclusions><exclusion><groupId>com.google.guava</groupId><artifactId>guava</artifactId></exclusion></exclusions></dependency>

方法2：强制指定版本

在项目中直接声明依赖，覆盖传递依赖：

<!-- 强制使用31.0版本 --><dependency><groupId>com.google.guava</groupId><artifactId>guava</artifactId><version>31.0-jre</version></dependency>

方法3：用dependencyManagement统一版本

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

所有模块都会使用这个版本。

常见冲突案例

案例1：日志框架冲突

SLF4J: Class path contains multiple SLF4J bindings.

项目里同时有logback和log4j的实现，需要排除一个：

<dependency><groupId>xxx</groupId><artifactId>xxx</artifactId><exclusions><exclusion><groupId>org.slf4j</groupId><artifactId>slf4j-log4j12</artifactId></exclusion></exclusions></dependency>

案例2：Jackson版本不一致

Incompatible Jackson version

用BOM统一版本：

<dependencyManagement><dependencies><dependency><groupId>com.fasterxml.jackson</groupId><artifactId>jackson-bom</artifactId><version>2.15.0</version><type>pom</type><scope>import</scope></dependency></dependencies></dependencyManagement>

IDEA插件帮忙

装个Maven Helper插件，可视化看依赖冲突：

1. 打开pom.xml
2. 点底部的Dependency Analyzer
3. 红色的就是冲突的依赖
4. 右键可以直接排除

比命令行方便多了。

预防措施

1. 用BOM管理版本

SpringBoot项目继承parent就自动管理了很多依赖版本：

<parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>3.2.0</version></parent>

2. 定期检查

mvn dependency:analyze

会提示哪些依赖用了但没声明，哪些声明了但没用。

本地没问题服务器报错？

有时候本地好好的，部署到服务器就冲突。可能是服务器环境的jar包和本地不一样。

我用星空组网把本地和服务器连起来，直接SSH上去看：

# 看实际加载了哪个版本的jarcd/app/libls-la|grepguava

或者启动时看类加载：

java -verbose:class -jar app.jar|grepguava

能快速定位是哪个版本被加载了。

小结

依赖冲突排查流程：

1. mvn dependency:tree -Dincludes=xxx找到冲突
2. 确定需要的版本
3. exclusion排除 或 直接声明覆盖
4. 再次dependency:tree验证

记住：用BOM管理版本能避免大部分冲突。

有问题评论区交流~