11_Maven 依赖冲突排查与解决方案实战在 Java 项目开发中随着引入的第三方类库越来越多Maven 依赖冲突是一个经常让人头疼的问题。本文将带大家深入了解什么是依赖冲突、产生的原因以及如何高效地排查和解决这些问题。一、 什么是依赖冲突依赖冲突是指项目中依赖的某一个 jar 包由于不同的引入路径导致存在多个不同的版本最终造成类包版本冲突的问题。为什么会产生依赖冲突依赖冲突通常是由类包之间的**间接依赖传递依赖**引起的。我们在pom.xml中显式声明的每一个依赖它自身可能还会依赖其他隐式的类包。这些隐式类包会被 Maven 间接引入到我们的项目中如果不同的显式依赖引入了同一个隐式依赖的不同版本就会产生冲突。二、 解决依赖冲突的核心思路解决依赖冲突的核心步骤非常简单查找到产生依赖冲突的 jar 包。剔找出我们不想要的版本手工将其排除在外即可。三、 排查依赖冲突的方法1. 通过命令行排查 (dependency:tree)可以使用 Maven 提供的dependency:tree命令来检查版本冲突mvn -Dverbose dependency:tree执行上述命令后控制台会输出类似以下的依赖树信息[INFO] com.sqnugy:pocket-ai-robot:jar:1.0.0 [INFO] - org.springframework:spring-context:jar:5.2.7.RELEASE:compile [INFO] | - (org.springframework:spring-aop:jar:6.2.6:compile - version managed from 5.2.7.RELEASE; omitted for conflict with 5.2.0.RELEASE) [INFO] | - org.springframework:spring-beans:jar:6.2.6:compile (version managed from 5.2.7.RELEASE) [INFO] | | - (org.springframework:spring-core:jar:6.2.6:compile - version managed from 6.2.6; omitted for duplicate) [INFO] | - org.springframework:spring-core:jar:6.2.6:compile (version managed from 5.2.7.RELEASE) [INFO] | | - org.springframework:spring-jcl:jar:6.2.6:compile (version managed from 6.2.6) [INFO] | - org.springframework:spring-expression:jar:6.2.6:compile (version managed from 5.2.7.RELEASE) [INFO] | - (org.springframework:spring-core:jar:6.2.6:compile - version managed from 6.2.6; omitted for duplicate) [INFO] - org.springframework:spring-aop:jar:5.2.0.RELEASE:compile (scope not updated to compile) [INFO] - (org.springframework:spring-beans:jar:6.2.6:compile - version managed from 5.2.0.RELEASE; omitted for duplicate) [INFO] - (org.springframework:spring-core:jar:6.2.6:compile - version managed from 5.2.0.RELEASE; omitted for duplicate)日志解析omitted for duplicate表示该jar包被重复依赖了。omitted for conflict with xxx说明该jar包和其他版本冲突了当前行的版本不会被引入。例如上面的提示omitted for conflict with 5.2.7.RELEASE意味着项目最终使用的是5.2.7版本而5.2.0版本被舍弃。2. 通过 IDEA 插件排查 (推荐)如果你使用的是 IntelliJ IDEA强烈建议安装Maven Helper插件。安装成功后打开pom.xml文件底部会多出一个Dependency Analyzer视图视图中主要有以下几个选项冲突查看存在的冲突重点关注All Dependency as List以列表形式查看所有依赖All Dependency as Tree以树状形式查看所有依赖点击存在冲突的jar包即可明显看到是哪几个包的引入导致了版本冲突四、解决冲突的四大策略假设我们目前的pom.xml如下项目引入了默认的spring-core5.2.7 版本但我们期望使用的是 5.2.0 版本有哪些操作dependencies dependency groupIdorg.springframework/groupId artifactIdspring-context/artifactId version5.2.7.RELEASE/version /dependency dependency groupIdorg.springframework/groupId artifactIdspring-aop/artifactId version5.2.0.RELEASE/version /dependency /dependencies策略一第一声明者优先原则Maven解析依赖时在pom.xml文件中自上而下谁先声明就优先使用谁的交付依赖。如果我们要使用5.2.0版本的spring-core由spring-aop提交只需将spring-aop的声明移到最前面即可dependencies dependency groupIdorg.springframework/groupId artifactIdspring-aop/artifactId version5.2.0.RELEASE/version /dependency dependency groupIdorg.springframework/groupId artifactIdspring-context/artifactId version5.2.7.RELEASE/version /dependency /dependencies查看依赖树[INFO] --- dependency:3.8.1:tree (default-cli) pocket-ai-robot --- [INFO] com.sqnugy:pocket-ai-robot:jar:1.0.0 [INFO] - org.springframework:spring-aop:jar:5.2.0.RELEASE:compile [INFO] | - org.springframework:spring-beans:jar:6.2.6:compile (version managed from 5.2.0.RELEASE) [INFO] | | \- (org.springframework:spring-core:jar:6.2.6:compile - version managed from 6.2.6; omitted for duplicate) [INFO] | \- org.springframework:spring-core:jar:6.2.6:compile (version managed from 5.2.0.RELEASE) [INFO] | \- org.springframework:spring-jcl:jar:6.2.6:compile (version managed from 6.2.6) [INFO] \- org.springframework:spring-context:jar:5.2.7.RELEASE:compile [INFO] - (org.springframework:spring-aop:jar:6.2.6:compile - version managed from 5.2.7.RELEASE; omitted for conflict with 5.2.0.RELEASE) [INFO] - (org.springframework:spring-beans:jar:6.2.6:compile - version managed from 5.2.7.RELEASE; omitted for duplicate) [INFO] - (org.springframework:spring-core:jar:6.2.6:compile - version managed from 5.2.7.RELEASE; omitted for duplicate) [INFO] \- org.springframework:spring-expression:jar:6.2.6:compile (version managed from 5.2.7.RELEASE) [INFO] \- (org.springframework:spring-core:jar:6.2.6:compile - version managed from 6.2.6; omitted for duplicate)策略2路径近者优先原则直接依赖直接依赖的优先级和交付依赖。我们可以以中pom.xml显式的方式将目标版本的依赖添加进去强制指定版本dependencies dependency groupIdorg.springframework/groupId artifactIdspring-context/artifactId version5.2.7.RELEASE/version /dependency dependency groupIdorg.springframework/groupId artifactIdspring-aop/artifactId version5.2.0.RELEASE/version /dependency dependency groupIdorg.springframework/groupId artifactIdspring-core/artifactId version5.2.0.RELEASE/version /dependency /dependencies策略3排除依赖Exclusions我们可以把不需要的依赖从它的上级依赖中明确除掉。使用 Maven Helper 插件可以很方便地完成在视图中右键单击要修复的 jar选择Exclude即可。它的基本原理是在pom.xml中自动添加了exclusions标签dependencies dependency groupIdorg.springframework/groupId artifactIdspring-context/artifactId version5.2.7.RELEASE/version exclusions exclusion artifactIdspring-core/artifactId groupIdorg.springframework/groupId /exclusion /exclusions /dependency dependency groupIdorg.springframework/groupId artifactIdspring-aop/artifactId version5.2.0.RELEASE/version /dependency /dependencies策略4版本锁定依赖管理 - ⭐推荐在多模块项目或多模块项目中使用dependencyManagement版本锁定是最优雅的做法。它可以统一管理项目的版本号确保所有模块的依赖版本一致。dependencyManagement dependencies dependency groupIdorg.springframework/groupId artifactIdspring-core/artifactId version5.2.0.RELEASE/version /dependency /dependencies /dependencyManagement dependencies dependency groupIdorg.springframework/groupId artifactIdspring-context/artifactId version5.2.7.RELEASE/version /dependency dependency groupIdorg.springframework/groupId artifactIdspring-aop/artifactId version5.2.0.RELEASE/version /dependency /dependencies注意dependencyManagement只是声明依赖其版本并不会自动实现引入。具体的子项目或当前项目中仍需要显着地式声明需要的依赖此时可以省略version标签。五、总结综上所述处理 Maven 依赖冲突可以得出以下两点建议冲突查强烈推荐使用Maven Helper插件图形化界面一目了然省去了看枯燥命令行的烦恼。注意dependencyManagement只是声明依赖其版本并不会自动实现引入。具体的子项目或当前项目中仍需要显着地式声明需要的依赖此时可以省略version标签。五、总结综上所述处理 Maven 依赖冲突可以得出以下两点建议冲突查强烈推荐使用Maven Helper插件图形化界面一目了然省去了看枯燥命令行的烦恼。解决冲突对于企业级开发个人最推荐使用**版本锁定dependencyManagement**的方法这有助于在架构方面保持全局依赖的一致性和可维护性。
11_Maven 依赖冲突排查与解决方案实战
11_Maven 依赖冲突排查与解决方案实战在 Java 项目开发中随着引入的第三方类库越来越多Maven 依赖冲突是一个经常让人头疼的问题。本文将带大家深入了解什么是依赖冲突、产生的原因以及如何高效地排查和解决这些问题。一、 什么是依赖冲突依赖冲突是指项目中依赖的某一个 jar 包由于不同的引入路径导致存在多个不同的版本最终造成类包版本冲突的问题。为什么会产生依赖冲突依赖冲突通常是由类包之间的**间接依赖传递依赖**引起的。我们在pom.xml中显式声明的每一个依赖它自身可能还会依赖其他隐式的类包。这些隐式类包会被 Maven 间接引入到我们的项目中如果不同的显式依赖引入了同一个隐式依赖的不同版本就会产生冲突。二、 解决依赖冲突的核心思路解决依赖冲突的核心步骤非常简单查找到产生依赖冲突的 jar 包。剔找出我们不想要的版本手工将其排除在外即可。三、 排查依赖冲突的方法1. 通过命令行排查 (dependency:tree)可以使用 Maven 提供的dependency:tree命令来检查版本冲突mvn -Dverbose dependency:tree执行上述命令后控制台会输出类似以下的依赖树信息[INFO] com.sqnugy:pocket-ai-robot:jar:1.0.0 [INFO] - org.springframework:spring-context:jar:5.2.7.RELEASE:compile [INFO] | - (org.springframework:spring-aop:jar:6.2.6:compile - version managed from 5.2.7.RELEASE; omitted for conflict with 5.2.0.RELEASE) [INFO] | - org.springframework:spring-beans:jar:6.2.6:compile (version managed from 5.2.7.RELEASE) [INFO] | | - (org.springframework:spring-core:jar:6.2.6:compile - version managed from 6.2.6; omitted for duplicate) [INFO] | - org.springframework:spring-core:jar:6.2.6:compile (version managed from 5.2.7.RELEASE) [INFO] | | - org.springframework:spring-jcl:jar:6.2.6:compile (version managed from 6.2.6) [INFO] | - org.springframework:spring-expression:jar:6.2.6:compile (version managed from 5.2.7.RELEASE) [INFO] | - (org.springframework:spring-core:jar:6.2.6:compile - version managed from 6.2.6; omitted for duplicate) [INFO] - org.springframework:spring-aop:jar:5.2.0.RELEASE:compile (scope not updated to compile) [INFO] - (org.springframework:spring-beans:jar:6.2.6:compile - version managed from 5.2.0.RELEASE; omitted for duplicate) [INFO] - (org.springframework:spring-core:jar:6.2.6:compile - version managed from 5.2.0.RELEASE; omitted for duplicate)日志解析omitted for duplicate表示该jar包被重复依赖了。omitted for conflict with xxx说明该jar包和其他版本冲突了当前行的版本不会被引入。例如上面的提示omitted for conflict with 5.2.7.RELEASE意味着项目最终使用的是5.2.7版本而5.2.0版本被舍弃。2. 通过 IDEA 插件排查 (推荐)如果你使用的是 IntelliJ IDEA强烈建议安装Maven Helper插件。安装成功后打开pom.xml文件底部会多出一个Dependency Analyzer视图视图中主要有以下几个选项冲突查看存在的冲突重点关注All Dependency as List以列表形式查看所有依赖All Dependency as Tree以树状形式查看所有依赖点击存在冲突的jar包即可明显看到是哪几个包的引入导致了版本冲突四、解决冲突的四大策略假设我们目前的pom.xml如下项目引入了默认的spring-core5.2.7 版本但我们期望使用的是 5.2.0 版本有哪些操作dependencies dependency groupIdorg.springframework/groupId artifactIdspring-context/artifactId version5.2.7.RELEASE/version /dependency dependency groupIdorg.springframework/groupId artifactIdspring-aop/artifactId version5.2.0.RELEASE/version /dependency /dependencies策略一第一声明者优先原则Maven解析依赖时在pom.xml文件中自上而下谁先声明就优先使用谁的交付依赖。如果我们要使用5.2.0版本的spring-core由spring-aop提交只需将spring-aop的声明移到最前面即可dependencies dependency groupIdorg.springframework/groupId artifactIdspring-aop/artifactId version5.2.0.RELEASE/version /dependency dependency groupIdorg.springframework/groupId artifactIdspring-context/artifactId version5.2.7.RELEASE/version /dependency /dependencies查看依赖树[INFO] --- dependency:3.8.1:tree (default-cli) pocket-ai-robot --- [INFO] com.sqnugy:pocket-ai-robot:jar:1.0.0 [INFO] - org.springframework:spring-aop:jar:5.2.0.RELEASE:compile [INFO] | - org.springframework:spring-beans:jar:6.2.6:compile (version managed from 5.2.0.RELEASE) [INFO] | | \- (org.springframework:spring-core:jar:6.2.6:compile - version managed from 6.2.6; omitted for duplicate) [INFO] | \- org.springframework:spring-core:jar:6.2.6:compile (version managed from 5.2.0.RELEASE) [INFO] | \- org.springframework:spring-jcl:jar:6.2.6:compile (version managed from 6.2.6) [INFO] \- org.springframework:spring-context:jar:5.2.7.RELEASE:compile [INFO] - (org.springframework:spring-aop:jar:6.2.6:compile - version managed from 5.2.7.RELEASE; omitted for conflict with 5.2.0.RELEASE) [INFO] - (org.springframework:spring-beans:jar:6.2.6:compile - version managed from 5.2.7.RELEASE; omitted for duplicate) [INFO] - (org.springframework:spring-core:jar:6.2.6:compile - version managed from 5.2.7.RELEASE; omitted for duplicate) [INFO] \- org.springframework:spring-expression:jar:6.2.6:compile (version managed from 5.2.7.RELEASE) [INFO] \- (org.springframework:spring-core:jar:6.2.6:compile - version managed from 6.2.6; omitted for duplicate)策略2路径近者优先原则直接依赖直接依赖的优先级和交付依赖。我们可以以中pom.xml显式的方式将目标版本的依赖添加进去强制指定版本dependencies dependency groupIdorg.springframework/groupId artifactIdspring-context/artifactId version5.2.7.RELEASE/version /dependency dependency groupIdorg.springframework/groupId artifactIdspring-aop/artifactId version5.2.0.RELEASE/version /dependency dependency groupIdorg.springframework/groupId artifactIdspring-core/artifactId version5.2.0.RELEASE/version /dependency /dependencies策略3排除依赖Exclusions我们可以把不需要的依赖从它的上级依赖中明确除掉。使用 Maven Helper 插件可以很方便地完成在视图中右键单击要修复的 jar选择Exclude即可。它的基本原理是在pom.xml中自动添加了exclusions标签dependencies dependency groupIdorg.springframework/groupId artifactIdspring-context/artifactId version5.2.7.RELEASE/version exclusions exclusion artifactIdspring-core/artifactId groupIdorg.springframework/groupId /exclusion /exclusions /dependency dependency groupIdorg.springframework/groupId artifactIdspring-aop/artifactId version5.2.0.RELEASE/version /dependency /dependencies策略4版本锁定依赖管理 - ⭐推荐在多模块项目或多模块项目中使用dependencyManagement版本锁定是最优雅的做法。它可以统一管理项目的版本号确保所有模块的依赖版本一致。dependencyManagement dependencies dependency groupIdorg.springframework/groupId artifactIdspring-core/artifactId version5.2.0.RELEASE/version /dependency /dependencies /dependencyManagement dependencies dependency groupIdorg.springframework/groupId artifactIdspring-context/artifactId version5.2.7.RELEASE/version /dependency dependency groupIdorg.springframework/groupId artifactIdspring-aop/artifactId version5.2.0.RELEASE/version /dependency /dependencies注意dependencyManagement只是声明依赖其版本并不会自动实现引入。具体的子项目或当前项目中仍需要显着地式声明需要的依赖此时可以省略version标签。五、总结综上所述处理 Maven 依赖冲突可以得出以下两点建议冲突查强烈推荐使用Maven Helper插件图形化界面一目了然省去了看枯燥命令行的烦恼。注意dependencyManagement只是声明依赖其版本并不会自动实现引入。具体的子项目或当前项目中仍需要显着地式声明需要的依赖此时可以省略version标签。五、总结综上所述处理 Maven 依赖冲突可以得出以下两点建议冲突查强烈推荐使用Maven Helper插件图形化界面一目了然省去了看枯燥命令行的烦恼。解决冲突对于企业级开发个人最推荐使用**版本锁定dependencyManagement**的方法这有助于在架构方面保持全局依赖的一致性和可维护性。
