sprinboot上传图片到minio

### Spring Boot 实现图片文件上传至 MinIO 对象存储 #### 1. 添加 Maven 依赖 为了使 Spring Boot 应用能够与 MinIO 进行交互，需在 `pom.xml` 中添加相应的依赖： ```xml <dependency> <groupId>io.minio</groupId> <artifactId|minio|</artifactId> <version>8.5.2</version> </dependency> ``` 此操作确保应用程序具备连接并操作 MinIO 所必需的功能[^3]。 #### 2. 配置 MinIO 客户端属性 编辑 `application.properties` 或者 `application.yml` 文件来设置 MinIO 的客户端配置项。以下是 YAML 格式的示例配置： ```yaml minio: endpoint: http://localhost:9000 # MinIO Server 地址 accessKey: YOUR_ACCESS_KEY # 访问密钥 secretKey: YOUR_SECRET_KEY # 秘钥 bucketName: your-bucket-name # 存储桶名称 ``` 这些配置允许应用程序通过指定的凭证访问特定位置上的 MinIO 服务实例[^1]。 #### 3. 编写控制器处理文件上传请求 创建一个新的 REST 控制器类用于接收来自前端用户的 HTTP POST 请求并将接收到的数据流保存到 MinIO 上面去。下面是一个简单的 Java 方法实现例子： ```java import io.minio.MinioClient; import org.springframework.web.bind.annotation.*; import org.springframework.web.multipart.MultipartFile; @RestController @RequestMapping("/api/files") public class FileUploadController { private final MinioClient minioClient; public FileUploadController(MinioClient minioClient) { this.minioClient = minioClient; } @PostMapping("/upload") public String uploadImage(@RequestParam("file") MultipartFile file) throws Exception { try { // 检查目标 Bucket 是否存在, 如果不存在则创建之. boolean isExist = minioClient.bucketExists(b -> b.bucket("your-bucket-name")); if (!isExist) { minioClient.makeBucket(mk -> mk.bucket("your-bucket-name")); } // 将文件上传到 MinIO 并返回其 URL 路径作为响应给调用方。 minioClient.putObject( PutObjectArgs.builder() .bucket("your-bucket-name") .object(file.getOriginalFilename()) .stream(file.getInputStream(), file.getSize(), -1) .contentType(file.getContentType()) .build()); return "File uploaded successfully."; } catch (Exception e) { throw new RuntimeException(e); } } } ``` 上述代码片段展示了如何利用 MinIO SDK 来完成基本的对象存取功能，包括检查存储桶是否存在以及实际执行文件传输过程中的细节处理。 #### 4. 初始化 MinIO 客户端 Bean 为了让上面定义的服务层方法正常工作，还需要注册一个 MinIO 客户端 bean 到 Spring 上下文中以便注入使用。可以在任意@Configuration 类内加入如下静态工厂方法： ```java @Bean public static MinioClient getMinioClient() { return MinioClient.builder() .endpoint("${minio.endpoint}") .credentials("${minio.accessKey}", "${minio.secretKey}") .build(); } ``` 这一步骤使得整个应用可以通过自动装配机制轻松获取已初始化好的 MinIO API 接口实例。 ---