如何通过Java客户端API使用预签名URL向Minio对象存储上传文件？

当然有办法实现！预签名URL的核心作用就是让客户端（不管是Java还是其他语言）直接和MinIO服务交互完成上传/下载操作，不需要通过你的后端中转。下面我给你一步步拆解实现流程和代码示例：

1. 生成预签名上传URL #

首先你需要用MinIO Java SDK生成一个带PUT方法的预签名URL（因为上传操作对应HTTP PUT请求）。这一步通常在你的后端服务中完成，然后把URL返回给客户端：

import io.minio.MinioClient;
import io.minio.Method;
import io.minio.errors.MinioException;
import java.util.concurrent.TimeUnit;

public class PresignedUploadUrlGenerator {
    public static void main(String[] args) {
        try {
            // 初始化MinIO客户端
            MinioClient minioClient = MinioClient.builder()
                    .endpoint("http://your-minio-server:9000")
                    .credentials("your-access-key", "your-secret-key")
                    .build();

            // 生成有效期1小时的预签名PUT URL
            String presignedUploadUrl = minioClient.getPresignedObjectUrl(
                    io.minio.GetPresignedObjectUrlArgs.builder()
                            .method(Method.PUT)
                            .bucket("your-target-bucket")
                            .object("path/to/remote/file.txt") // 上传到MinIO后的对象路径
                            .expiry(1, TimeUnit.HOURS)
                            .build());

            System.out.println("生成的预签名上传URL: " + presignedUploadUrl);
        } catch (MinioException e) {
            System.err.println("生成预签名URL出错: " + e.getMessage());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

2. 使用Java客户端上传文件到预签名URL #

拿到预签名URL后，你可以用Java的HTTP客户端发送PUT请求，把本地文件上传到MinIO：

方法一：使用Java 11+ HttpClient #

import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class PresignedUrlFileUploader {
    public static void main(String[] args) {
        String presignedUrl = "替换成你生成的预签名URL";
        File localFile = new File("path/to/your/local/file.txt");

        // 创建HTTP客户端
        HttpClient httpClient = HttpClient.newHttpClient();

        try (FileInputStream fileInputStream = new FileInputStream(localFile)) {
            // 构建PUT请求
            HttpRequest uploadRequest = HttpRequest.newBuilder()
                    .uri(URI.create(presignedUrl))
                    .PUT(HttpRequest.BodyPublishers.ofInputStream(() -> fileInputStream))
                    .header("Content-Type", "text/plain") // 根据文件类型设置正确的Content-Type，比如image/jpeg、application/pdf等
                    .build();

            // 发送请求并处理响应
            HttpResponse<Void> response = httpClient.send(uploadRequest, HttpResponse.BodyHandlers.discarding());

            if (response.statusCode() == 200) {
                System.out.println("文件上传成功！");
            } else {
                System.err.println("上传失败，状态码: " + response.statusCode());
            }
        } catch (IOException | InterruptedException e) {
            System.err.println("上传过程中出现异常:");
            e.printStackTrace();
        }
    }
}

方法二：使用Apache HttpClient（适用于Java 11之前的版本） #

如果你用的是Java 8或更早版本，可以用Apache HttpClient来实现：

import org.apache.http.HttpEntity;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPut;
import org.apache.http.entity.FileEntity;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import java.io.File;
import java.io.IOException;

public class ApacheHttpClientUploader {
    public static void main(String[] args) {
        String presignedUrl = "替换成你生成的预签名URL";
        File localFile = new File("path/to/your/local/file.txt");

        try (CloseableHttpClient httpClient = HttpClients.createDefault()) {
            HttpPut putRequest = new HttpPut(presignedUrl);
            FileEntity fileEntity = new FileEntity(localFile);
            putRequest.setEntity(fileEntity);
            putRequest.setHeader("Content-Type", "text/plain");

            try (CloseableHttpResponse response = httpClient.execute(putRequest)) {
                int statusCode = response.getStatusLine().getStatusCode();
                if (statusCode == 200) {
                    System.out.println("文件上传成功！");
                } else {
                    System.err.println("上传失败，状态码: " + statusCode);
                }
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

关键注意事项 #

• HTTP方法匹配：生成预签名URL时必须指定Method.PUT，上传请求也要用PUT方法，否则MinIO会拒绝请求。
• Content-Type正确性：上传时设置的Content-Type要和文件实际类型一致，避免出现对象类型识别错误。
• URL有效期：预签名URL有过期时间，要确保在有效期内完成上传操作。
• CORS配置：如果你的客户端是前端（比如浏览器），需要在MinIO控制台配置CORS规则，允许对应的域名发起PUT请求；如果是Java后端客户端调用，通常不需要担心跨域问题。
• 大文件上传：如果要上传GB级别的大文件，可以结合MinIO的分块上传API生成预签名分块URL，然后分块上传后再合并，这个场景下需要额外处理分块逻辑。

内容的提问来源于stack exchange，提问作者A.Dumas