Spring Boot项目中azure-storage-blob依赖版本不一致问题排查

依赖版本差异的原因 #

• Spring Boot依赖管理差异：第二个项目由Spring Initializr生成，默认继承spring-boot-starter-parent，它的dependencyManagement已经统一管理了netty系列依赖的版本（对应你看到的4.1.97.Final）。而第一个项目是现有改造项目，可能未继承官方parent，或者自身/父pom的dependencyManagement定义了旧版netty，也可能是其他第三方依赖（如Spring Cloud、自定义组件）引入了4.1.59.Final版本的netty-resolver，Maven依赖仲裁时选择了旧版。
• 传递依赖优先级规则：Maven依赖仲裁遵循「路径最短优先，同路径下声明顺序优先」。第一个项目中可能有其他依赖（如旧版reactor-netty、spring-webflux）比azure-storage-blob更早引入了4.1.59.Final，导致你排除azure-storage-blob的netty-resolver后，旧版本依然被其他依赖带入。

排查依赖来源的实用步骤 #

• 精准定位依赖路径：执行命令

  mvn dependency:tree -Dverbose -Dincludes=io.netty:netty-resolver
  

  该命令会只输出netty-resolver的完整依赖树，直接看到是哪个上游依赖引入了4.1.59.Final版本。
• 检查全局依赖管理：查看第一个项目的pom.xml及所有父pom的dependencyManagement节点，确认是否有直接定义io.netty:netty-resolver的版本，若有则修改为4.1.97.Final。
• 对比项目基础依赖：将第一个项目的核心依赖（如spring-boot-starter-web、spring-boot-starter-webflux等）版本与第二个Initializr生成的项目对齐，这些基础依赖通常会附带兼容的netty版本。

解决NoClassDefFoundError异常 #

出现reactor/netty/http/client/HttpClient找不到的问题，是因为你单独升级了netty-resolver，但未同步升级与之绑定的reactor-netty版本——netty和reactor-netty版本强关联，版本不兼容就会导致类缺失。解决方式：

• 统一依赖管理（推荐）：如果第一个项目未继承spring-boot-starter-parent，在pom.xml中加入spring-boot-dependencies的dependencyManagement，指定和第二个项目相同的Spring Boot版本，这样所有相关依赖（netty、reactor-netty等）都会自动对齐到兼容版本：

  <dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-dependencies</artifactId>
        <version>你的第二个项目使用的Spring Boot版本</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
    </dependencies>
  </dependencyManagement>
  

• 显式对齐reactor-netty版本：如果不想全局统一，可单独引入与4.1.97.Final兼容的reactor-netty版本（比如Spring Boot 2.7.x对应reactor-netty 1.0.28+，Spring Boot 3.x对应1.1.x系列），确保版本匹配。

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