Spring 5创建azure-storage-blob的BlobServiceClient报异常如何解决

核心错误原因 #

你遇到的报错本质是依赖版本不匹配和传递依赖冲突两个问题导致的，具体修复方案如下：

• 首先修正azure-core-http-netty版本：你使用的azure-storage-blob:12.3.0最低要求azure-core-http-netty:1.3.0版本，你当前引入的1.2.0版本没有适配对应底层HTTP客户端的逻辑，无法兼容对应版本的storage SDK，将该依赖版本升级到1.3.0及以上兼容版本即可。
• 排查reactor-netty依赖冲突：Spring 5如果集成了WebFlux或者其他响应式组件，会自带对应版本的reactor-netty包，可能和azure-core-http-netty传递引入的reactor-netty版本不一致，导致类加载时找不到对应类。你可以使用依赖树命令排查实际生效的reactor-netty版本：
  • Maven项目执行：mvn dependency:tree | grep reactor-netty
  • Gradle项目执行：gradlew dependencies | grep reactor-netty
    确保生效版本为reactor-netty:0.9.4.RELEASE及以上的兼容版本，低版本reactor-netty不存在对应HttpClient实现类。
• 统一锁定依赖版本：在项目的依赖管理节点（Maven的<dependencyManagement>、Gradle的dependencyManagement）统一锁定所有azure相关依赖的版本，避免不同传递依赖引入的版本漂移问题，同时检查WAR包的lib目录下是否存在多个版本的azure-core、reactor-netty包，删除老旧版本的重复依赖。

可选替代方案 #

如果你不想调整现有项目的Netty版本，可以将底层HTTP客户端替换为OkHttp实现，避免和现有Netty依赖冲突：

1. 移除azure-core-http-netty依赖，引入com.azure:azure-core-http-okhttp:1.2.0及以上兼容版本
2. 手动指定HTTP客户端的代码调整为OkHttp实现即可，其他业务逻辑无需修改。

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