如何使用MinIO Java SDK判断存储桶内对象是否存在？

前置依赖 #

首先引入最新稳定版MinIO Java SDK，Maven坐标如下：

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

核心实现逻辑 #

高版本（8.x）MinIO Java SDK移除了旧版直接返回布尔值的文件存在判断接口，目前官方推荐的实现方式是通过查询对象元数据的statObject接口实现：接口调用成功说明文件存在，捕获到404状态码的响应异常说明文件不存在，其余异常直接抛出避免吞错。

完整代码实现 #

1. 初始化MinIO客户端（Spring托管Bean） #

import io.minio.MinioClient;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class MinioConfig {
    @Value("${minio.endpoint}")
    private String endpoint;
    @Value("${minio.accessKey}")
    private String accessKey;
    @Value("${minio.secretKey}")
    private String secretKey;

    @Bean
    public MinioClient minioClient() {
        return MinioClient.builder()
                .endpoint(endpoint)
                .credentials(accessKey, secretKey)
                .build();
    }
}

在Spring配置文件（application.yml/properties）中补充对应配置项即可。

2. 编写文件存在性校验方法 #

import io.minio.MinioClient;
import io.minio.StatObjectArgs;
import io.minio.errors.ErrorResponseException;
import io.minio.messages.StatObjectResponse;
import org.springframework.stereotype.Component;
import javax.annotation.Resource;

@Component
public class MinioFileService {
    @Resource
    private MinioClient minioClient;

    /**
     * 判断指定桶内目标文件是否存在
     * @param bucketName 存储桶名称
     * @param objectName 文件对象全路径
     * @return 存在返回true，不存在返回false
     */
    public boolean checkFileExists(String bucketName, String objectName) {
        try {
            StatObjectResponse stat = minioClient.statObject(
                    StatObjectArgs.builder()
                            .bucket(bucketName)
                            .object(objectName)
                            .build()
            );
            return stat != null;
        } catch (ErrorResponseException e) {
            // 404状态码对应对象/资源不存在
            if (e.response().code() == 404) {
                return false;
            }
            throw new RuntimeException("校验文件存在性失败：" + e.getLocalizedMessage(), e);
        } catch (Exception e) {
            throw new RuntimeException("MinIO服务调用异常：" + e.getLocalizedMessage(), e);
        }
    }
}

注意事项 #

• 网上旧教程提到的objectExists()方法、statObject().isExist()链式调用写法在8.0以上版本中已被废弃移除，直接调用会报方法不存在的错误，这也是旧方案失效的核心原因
• 禁止使用listObjects()遍历对象列表匹配文件名的方式做存在性校验，存储桶内文件量较大时该方案性能极差，还可能触发MinIO的请求限流
• MinIO是强一致存储，文件上传完成后无需加延迟等待，可直接调用该方法做上传结果校验
• 如果开启了对象版本控制，需要校验指定历史版本的文件是否存在，只需要在构建StatObjectArgs时追加.versionId(你的版本ID)参数即可
• 不要在捕获异常时将所有错误都判定为文件不存在，桶不存在、权限不足、网络异常等场景抛出的非404错误需要正常抛出，方便排查问题

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