迁移至Spring Boot 3后spring-boot-starter-minio无法使用的解决办法

我有一个基于Spring Boot和MinIO的应用，引入的MinIO依赖如下：

<dependency>
    <groupId>com.jlefebure</groupId>
    <artifactId>spring-boot-starter-minio</artifactId>
    <version>1.4</version>
</dependency>

将应用从Spring Boot 2.3.8.RELEASE迁移到3.0.2后，启动时出现如下错误：

Consider defining a bean of type 'com.jlefebure.spring.boot.minio.MinioService' in your configuration.

根据Spring Boot 3.0迁移指南，Spring Boot 3.0.2需用META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports文件替代spring.factories文件实现自动配置，但该依赖仍使用spring.factories，这可能是迁移后自动配置失效的原因。需要解决如何让spring-boot-starter-minio适配Spring Boot 3，或者手动创建MinioService Bean的问题。

方案一：升级依赖到适配Spring Boot3的版本 #

先检查com.jlefebure:spring-boot-starter-minio是否有支持Spring Boot3的新版本。这类starter通常从2.x版本开始适配Spring Boot3，找到对应版本后直接升级依赖即可，示例如下：

<dependency>
    <groupId>com.jlefebure</groupId>
    <artifactId>spring-boot-starter-minio</artifactId>
    <version>2.1.0</version> <!-- 以实际可用的适配版本为准 -->
</dependency>

升级完成后，新版本会替换自动配置的实现方式，MinioService Bean就能正常加载。

方案二：手动创建MinioService Bean #

如果暂时无法升级依赖，可通过手动配置类创建MinioService Bean，步骤如下：

1. 创建配置类MinioConfig，开启MinIO配置参数的注入（配置参数需提前在application.properties或application.yml中定义）：

import com.jlefebure.spring.boot.minio.MinioProperties;
import com.jlefebure.spring.boot.minio.MinioService;
import io.minio.MinioClient;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
@EnableConfigurationProperties(MinioProperties.class)
public class MinioConfig {

    @Bean
    public MinioClient minioClient(MinioProperties properties) {
        return MinioClient.builder()
                .endpoint(properties.getUrl())
                .credentials(properties.getAccessKey(), properties.getSecretKey())
                .build();
    }

    @Bean
    public MinioService minioService(MinioClient minioClient, MinioProperties properties) {
        return new MinioService(minioClient, properties);
    }
}

2. 确保配置文件中已添加MinIO的必要参数，示例：

minio.url=http://你的MinIO服务器地址:9000
minio.access-key=你的访问密钥
minio.secret-key=你的秘密密钥
minio.bucket=默认存储桶名称 # 可选，根据业务需求配置

配置完成后，Spring Boot启动时会自动加载手动定义的MinioService Bean，解决找不到Bean的问题。

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