Maven多版本传递依赖的版本选择机制及问题排查

先给你理清楚Maven处理多版本依赖的核心规则，再对应你的情况分析原因：

Maven依赖版本选择的优先级顺序 #

Maven处理依赖冲突时，会按照以下优先级来选版本：

1. 依赖管理（Dependency Management）优先级最高：如果你的项目（或者它继承的父POM）的<dependencyManagement>块里声明了某个依赖的版本，Maven会强制把整个依赖树里的该依赖统一成这个版本，不管各个子依赖自己声明的是什么版本。你看到的version managed from x.x提示，就是这个机制在起作用。
2. 路径最短原则（Nearest Wins）：如果没有依赖管理的约束，Maven会选离项目根节点最近的版本——也就是项目直接依赖的版本，会比“依赖的依赖”这种间接依赖的版本优先级高。
3. 声明顺序优先（First Declaration Wins）：如果两个依赖的路径长度一样（比如都是间接依赖，且层级相同），Maven会选在POM里先出现的那个版本。

为什么microservices-common单独构建时能选对1.11版本？ #

看你提供的microservices-common依赖树：

[INFO] com.myproject:microservice-common:jar:1.0-SNAPSHOT 
[INFO] +- commons-codec:commons-codec:jar:1.11:compile 
[INFO] +- org.apache.httpcomponents:httpclient:jar:4.5.5:compile 
[INFO] | \- (commons-codec:commons-codec:jar:1.10:compile - omitted for conflict with 1.11) 
[INFO] \- com.myproject:restful:jar:4.1.5-SNAPSHOT:compile 
[INFO] +- com.myproject:restful-common:jar:4.1.5-SNAPSHOT:compile 
[INFO] | \- (commons-codec:commons-codec:jar:1.8:compile - omitted for conflict with 1.11) 
[INFO] \- (commons-codec:commons-codec:jar:1.8:compile - omitted for conflict with 1.11)

这里microservices-common自己的POM直接声明了commons-codec:1.11，属于路径最短的依赖（直接依赖），而httpclient、restful带来的1.10、1.8都是间接依赖（路径更长）。同时，microservices-common的依赖管理里没有指定更低的版本，所以Maven按照路径最短原则，保留了1.11，把其他冲突版本排除了，结果符合预期。

为什么你的项目里却变成了1.10版本？ #

看项目的依赖树里的关键提示：

[INFO] | \- (commons-codec:commons-codec:jar:1.10:compile - version managed from 1.11; omitted for duplicate)
[INFO] +- commons-codec:commons-codec:jar:1.10:compile

这里的version managed from 1.11是核心线索——你的项目（或者它继承的父POM）的<dependencyManagement>里，强制指定了commons-codec的版本是1.10！

Maven的依赖管理是全局生效的：不管microservices-common自己声明了1.11，只要项目的依赖管理里写了1.10，所有地方的commons-codec都会被覆盖成1.10。这就导致：

• microservices-common原本依赖的1.11被强制改成了1.10
• restful依赖带来的1.8也被改成了1.10
• 最终整个项目的类路径里只有1.10版本，而microservices-common用到了1.11新增的构造方法，自然编译失败。

解决思路 #

找到你的项目（或者父POM）的<dependencyManagement>块，把commons-codec的版本更新为1.11，这样整个依赖树里的该依赖都会统一成1.11，和microservices-common的要求匹配。

如果暂时不能修改全局依赖管理，也可以在你的项目的<dependencies>里直接声明commons-codec:1.11——根据路径最短原则，直接依赖的版本会覆盖依赖管理的版本（不过这种方式属于局部修复，更推荐统一依赖管理来避免后续冲突）。

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