MinIO Java 对接试用：从连接、上传到下载的完整示例

一、先明确 MinIO 的对象模型

开发者常见误区：

• /report.pdf 不是本地文件方法！这是MinIO中的对象键，只是一个字符串前缀
• demo-files/report.pdf 不是目录结构！MinIO没有真正的"目录"概念
• /report.pdf 和 /folder/report.pdf 是完全不同的两个对象

主要概念表格：

二、准备试用环境

⚠️ 警告 ⚠️ 不要直接使用管理员账号连接业务程序！话说回来，首次试用请创建独立测试桶和最小权限账号。

再看minio，endpoint: http://192.168.1.10:9000 # 生产环境需HTTPS+域名
access-key: AKIAIOSFODNN7EXAMPLE # 测试账号
secret-key: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY # 测试密钥
说到bucket，demo-files-test-env # 开发专用桶
❗ 注意 ❗ 开发机可以临时设置环境变量：
$env这方面。MINIO_ENDPOINT = "http://localhost"
说到$env，MINIO_ACCESS_KEY = "testuser"
说到$env，MINIO_SECRET_KEY = "testpassword"
$env这方面，MINIO_BUCKET = "dev-test-bucket"

三、引入 Java SDK 

⚠️ 警告 ⚠️ 不要在多个模块写不同版本！话说回来，SDK更新可能带来兼容性问题。





四、Spring Boot 配置 
❗ 注意 ❗ 不要把secret-key提交到Git。建议使用Vault或AWS Secrets Manager等工具管理生产凭证。

五、创建 MinioClient Bean 
六、封装常用操作
public ObjectStorageService String bucket) {
this.client = client;
this.bucket = bucket;}
// 自动创建桶如果不存在 try { boolean exists = client.bucketExists(
BucketExistsArgs.builder.bucket.build);

if {client.makeBucket.bucket.build);} } catch { log.error;话说回来，throw new StorageException;}

public void upload throws Exception { try { // 自动关闭流 client.putObject .bucket .object .stream .contentType .build);} catch { log.warn;throw new StorageException;}

public InputStream download throws Exception { try { return client.getObject .bucket.object.build);话说回来，} catch { throw new FileNotFoundException;}

// 生成有效期限制的预签名URL public String presignedGetUrl throws Exception { return client.getPresignedObjectUrl .method.bucket.object.expiry.responseContentDisposition // 强制下载而不是浏览器预览.build);

// 安全删除并记录审计日志 public void delete throws Exception { try { client.removeObject.bucket);不过，log.info，catch { log.warn;} }

⚠️ 注意事项：




七、提供一个联调接口