记录Maven包（okhttp3）版本指定无效_unsupported okhttp library found. must use okhttp

问题背景

SprintBoot项目使用MinIO，根据官网使用Maven导入JavaSDK

<dependency>
   <groupId>io.minio</groupId>
   <artifactId>minio</artifactId>
   <version>${minio.version}</version>
</dependency>
1
2
3
4
5

运行报错：
Caused by: java.lang.RuntimeException: Unsupported OkHttp library found. Must use okhttp >= 4.8.1
at io.minio.S3Base.(S3Base.java:106)
… 72 more
Caused by: java.lang.NoSuchMethodError: ‘okhttp3.RequestBody okhttp3.RequestBody.create(byte[], okhttp3.MediaType)’
at io.minio.S3Base.(S3Base.java:104)
… 72 more

解决过程

1. 排查minio的Maven包的依赖
   
   发现是依赖了okhttp 4.10.0，依赖明显>=4.8.1。既然minio自己本身的依赖没有问题，那就考虑是okhttp包发生了依赖冲突。
2. 分析项目对okhttp依赖
   
   项目是一个Maven多模块的项目，排查了父包、公共包和出错的子包之后发现只有minio依赖了Okhttp。这就很迷惑了，为什么明明依赖的版本是4.10.0，但是排查出来的依赖版本变成了3.14.9。
3. 尝试排除依赖重新指定
   
   如上修改后，明确指定了OkHttp版本的Maven项目可以正常运行，但是依赖该Maven项目的其他子项目依旧恢复OkHttp版本为3.14.9。这不就是灵异事件嘛！
4. 灵光一现
   突然发现指定okhttp依赖时左边IDEA提示了是继承的，即有包指定了Okhttp的版本。点进去一看，好家伙SprintBoot依赖包中指定了OkHttp版本，版本号就是3.14.9。而我的项目的根项目就指定了SpringBoot的版本，子项目中使用了SpringBoot！了解了一下，Maven包如果存在依赖管理（dependencyManagement）那么该模块的子模块和依赖包中的相关包都将自动使用这个版本，而且子模块可以覆盖、依赖包中的依赖管理会被引用者覆盖。

解决方案

在根模块的POM中添加dependencyManagement，这样会覆盖掉SpringBoot指定的依赖版本。

<dependencyManagement>
	<dependencies>
		<!-- MinIO -->
		<dependency>
		    <groupId>io.minio</groupId>
		    <artifactId>minio</artifactId>
		    <version>${minio.version}</version>
		</dependency>
		<dependency>
		    <groupId>com.squareup.okhttp3</groupId>
		    <artifactId>okhttp</artifactId>
		    <version>4.10.0</version>
		</dependency>
	</dependencyManagement>
</dependencies>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15