Maven依赖版本异常排查：Reactor-Netty与Netty版本冲突问题

一、移除reactor-netty-http后，mvn dependency:tree不显示Netty但mvn help:effective-pom能看到的原因 #

• dependency:tree的默认展示范围限制：这个命令默认只输出compile、runtime、system三个范围的依赖。如果Netty依赖是通过provided、test等其他范围引入，或者仅在dependencyManagement中做了版本声明但未被实际依赖引用，dependency:tree就不会将其列入结果，但effective-pom会包含所有dependencyManagement条目以及全范围的依赖定义。
• Spring Boot父POM的版本管理特性：Spring Boot的父依赖会通过dependencyManagement统一管控大量第三方库的版本，其中就包括Netty。即便你没有直接引入Netty，只要父POM里有相关版本声明，effective-pom就会显示这些内容，但只有当某个依赖实际触发引用Netty时，dependency:tree才会展示它。

二、reactor-netty-http:1.2.5使用Netty 4.1.116而非4.1.119的原因 #

从你提供的依赖树输出能发现核心问题：项目中引入的reactor-netty-core版本是1.2.1，而非与reactor-netty-http:1.2.5匹配的1.2.5版本。reactor-netty-core:1.2.1本身依赖的Netty版本就是4.1.116，这直接导致了所有Netty组件版本被拉低。

具体触发场景通常有两种：

1. Maven版本仲裁机制：Maven遵循“路径最短优先”的版本选择规则，如果项目中存在另一个依赖直接引入了reactor-netty-core:1.2.1，它的依赖路径比reactor-netty-http:1.2.5间接引入的reactor-netty-core:1.2.5更短，Maven就会优先选择1.2.1版本。
2. Spring Boot父POM的版本锁定：如果你的Spring Boot版本对应的reactor-netty基线版本是1.2.1，父POM的dependencyManagement会强制锁定reactor-netty系列组件的版本，即便你手动指定reactor-netty-http:1.2.5，也可能出现reactor-netty-core被拉回1.2.1的情况（不过这种场景下通常reactor-netty-http也会被同步拉低，你的情况更倾向于第一种依赖冲突）。

验证与修复建议 #

• 执行mvn dependency:tree -Dverbose命令，查看完整的依赖冲突详情，该命令会列出所有版本的依赖项，并标注最终版本的选择原因。
• 在POM的dependencyManagement区块中显式声明reactor-netty-core:1.2.5以及io.netty相关组件的4.1.119版本，强制Maven使用指定版本。
• 排查项目中其他依赖，定位引入reactor-netty-core:1.2.1的来源，评估是否可以升级该依赖的版本，使其与reactor-netty-http:1.2.5兼容。

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