使用Minio异常解决Caused by: java.lang.NoClassDefFoundError: io/minio/MinioClient

最新推荐文章于 2025-06-10 16:25:43 发布

原创最新推荐文章于 2025-06-10 16:25:43 发布 · 9k 阅读

5 ·

CC 4.0 BY-SA版权

文章标签：

#java #开发语言 #后端

Java 同时被 2 个专栏收录

16 篇文章

订阅专栏

Minio

1 篇文章

订阅专栏

在尝试使用Java 8.3.3版本的Minio SDK接入服务时，遇到了`NoClassDefFoundError: io/minio/MinioClient`的问题。经过排查，发现是因为Minio内部依赖的okhttp版本不兼容。为解决此问题，排除了Minio中自带的okhttp依赖，并引入了更高版本的okhttp（4.9.0），最终成功解决问题。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

起因

今天使用java接入Minio服务，参考官方文档SDK：
https://docs.min.io/docs/java-client-quickstart-guide.html
和当时官方依赖版本一致：8.3.3

<dependency>
    <groupId>io.minio</groupId>
    <artifactId>minio</artifactId>
    <version>8.3.3</version>
</dependency>

报错如下：

Caused by: java.lang.NoClassDefFoundError: io/minio/MinioClient

当时已反复确认依赖已经引入，奇怪为什么会报找不到类

接着单独起了一个环境完全根据官方文件代码操作，最后报了个其他错误：
Caused by: java.lang.RuntimeException: Unsupported OkHttp library found. Must use okhttp >= 4.8.1

我…

接着把用Maven helper工具把minio里面的okhttp包快速排掉
重新引入高版本的，成功解决

<dependency>
    <groupId>com.squareup.okhttp3</groupId>
    <artifactId>okhttp</artifactId>
    <version>4.9.0</version>
</dependency>

注：minio排包

<!--minio服务-->
<dependency>
   <groupId>io.minio</groupId>
   <artifactId>minio</artifactId>
   <version>8.3.3</version>
   <exclusions>
       <exclusion>
           <artifactId>okhttp</artifactId>
           <groupId>com.squareup.okhttp3</groupId>
       </exclusion>
   </exclusions>
</dependency>