SpringBoot项目实战：5分钟搞定Minio文件上传下载（附完整配置代码）

SpringBoot极简集成Minio：5分钟实现企业级文件管理

对象存储在现代应用开发中已成为刚需，但传统方案要么过于笨重（如传统NAS），要么成本高昂（如公有云存储）。Minio作为高性能的开源对象存储方案，凭借轻量级、兼容S3协议的特性，正在Java生态中快速普及。本文将带你用SpringBoot在5分钟内构建完整的文件上传、下载、分享功能链，所有代码均经过生产验证，可直接用于商业项目。

1. 环境准备与最小化配置

1.1 依赖引入与配置

在pom.xml中添加唯一必需依赖（建议使用最新稳定版）：

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

application.yml配置示例（支持多环境配置）：

minio:
  endpoint: http://minio.example.com
  access-key: your_access_key
  secret-key: your_secret_key
  bucket: default-bucket
  secure: false  # HTTPS设为true
  region: us-east-1 # 兼容AWS S3的区域设置

1.2 自动配置类实现

创建自动装配的配置类，避免手动初始化：

@Configuration
@EnableConfigurationProperties(MinioProperties.class)
public class MinioAutoConfiguration {
    
    @Bean
    public MinioClient minioClient(MinioProperties properties) {
        return MinioClient.builder()
                .endpoint(properties.getEndpoint())
                .credentials(properties.getAccessKey(), properties.getSecretKey())
                .region(properties.getRegion())
                .build();
    }
    
    @Bean
    @ConditionalOnMissingBean
    public Min