SpringBoot整合MinIO实战：5分钟搞定文件上传下载（附完整代码）

原创

于 2026-02-18 14:41:10 发布 · 454 阅读

SpringBoot整合MinIO实战：5分钟搞定文件上传下载（附完整代码）

对象存储技术正在成为现代应用开发中不可或缺的基础设施。相比传统文件系统，它提供了更高的扩展性、可靠性和成本效益。MinIO作为一款高性能的开源对象存储解决方案，凭借其轻量级、易部署和完全兼容Amazon S3 API的特性，已经成为开发者构建云原生存储系统的首选。

本文将带你快速实现SpringBoot与MinIO的整合，通过实战演示如何用最简洁的代码完成文件上传下载功能。不同于基础教程，我们会重点关注生产环境中的最佳实践，包括自动配置、异常处理和性能优化等关键细节。

1. 环境准备与基础配置

在开始编码前，我们需要准备好开发环境。确保你的系统已经安装JDK 1.8或更高版本，以及Maven构建工具。同时需要一个可访问的MinIO服务实例——可以是本地部署的测试服务器，也可以是云端的生产环境。

首先创建SpringBoot项目，在pom.xml中添加必要的依赖：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>io.minio</groupId>
        <artifactId>minio</artifactId>
        <version>8.5.2</version>
    </dependency>
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <optional>true</optional>
    </dependency>
</dependencies>

接下来配置MinIO连接参数。在application.yml中添加以下配置：

minio:
  endpoint: http://localhost:9000
  access-key: your-access-key
  secret-key: your-secret-key
  bucket: default-bucket
  secure: false

创建配置类将这些参数注入到Spring容器中：

@Configuration
@ConfigurationProperties(prefix = "minio")
@Data
public class MinioConfig {
    private String endpoint;
    private String accessKey;
    private String secretKey;
    private String bucket;
    private boolean secure;

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

这个配置类使用@ConfigurationProperties自动绑定配置文件中的属性，并通过@Bean将MinioClient实例交给Spring管理。注意我们使用了Lombok的@Data注解来简化getter/setter的编写。