Maven项目直接依赖触发Dependency Convergence Error问题咨询

问题解答 #

你的理解存在部分偏差，核心差异在于maven-enforcer-plugin的Dependency Convergence校验规则和Maven本身的依赖调解逻辑是两套独立的运行规则：

• 你对Maven默认依赖调解的认知是正确的：按照Maven官方的「最短路径优先」调解原则，你在项目A中直接声明的B:1.0属于一级依赖，路径长度短于C传递引入的B:1.1的二级依赖，最终项目实际运行时确实会使用B:1.0版本。
• Dependency Convergence规则的设计目标和Maven默认调解逻辑完全不同：它的核心作用是从根源上规避隐式依赖版本选择带来的潜在风险，会扫描全依赖树中所有相同groupId和artifactId的依赖，只要存在多个不同版本，无论Maven本身能不能调解出最终生效版本，都会直接抛出报错。该规则的设计初衷就是强制开发者显式处理所有版本冲突，避免后续依赖结构变动时，实际使用的版本发生预期外的变化。

常见解决方案

你可以根据业务需求选择任意一种方案解决该报错：

• 全局锁定版本：在项目A的dependencyManagement节点中显式声明B的版本为1.0，enforcer插件会识别到你主动锁定了全局版本，不再触发收敛报错
• 排除传递依赖：在A对C:1.0的依赖声明中添加exclusions规则，排除C传递引入的B:1.1依赖
• 统一依赖版本：如果B:1.1兼容当前业务逻辑，可以将A直接依赖的B版本升级为1.1，让全依赖树的B版本完全一致
• 配置忽略规则：如果确认可以接受当前版本差异，可以在maven-enforcer-plugin的配置中添加针对B的收敛校验忽略规则

内容的提问来源于stack exchange，提问作者KevinZhou