MinIO客户端初始化后必须立即探活、严格匹配协议/端口、确保reader可seek重读；否则易出现连接失败、上传卡顿或OOM。探活用BucketExists/ListBuckets，endpoint协议与Secure配置须与服务端一致，上传大文件需用os.File+timeout context，下载后须检查err并Close。
MinIO 客户端初始化后不报错，不代表能用；绝大多数“连不上”“上传卡住”“读不到数据”问题，都出在初始化没探活、协议/端口配错、或 reader 不可重读这三处。
minio.New 初始化后必须立刻调用 BucketExists 或 ListBuckets 探活
minio.New 只解析参数，不发任何网络请求。endpoint 写成 "localhost:9000"（缺协议）、"http://127.0.0.1:9000"（多协议）、或 secure 配反，全都不会在初始化时报错。
- 务必紧接着调用
client.BucketExists(ctx, "test-bucket")或client.ListBuckets(ctx)，哪怕桶名不存在——权限错误、TLS 握手失败、签名不匹配都会在这里暴露为err != nil -
BucketExists对不存在的桶返回exists=false, err=nil；但只要err != nil，就说明认证、网络或服务端配置有问题 - 别用
MakeBucket替代探活：它在桶已存在时返回minio.ErrBucketAlreadyOwnedByYou，不是幂等操作，容易误判为失败
endpoint 协议和端口必须与 MinIO 启动方式严格一致
MinIO 默认监听 :9000（HTTP），加 --console-address :9002 也不影响对象 API 端口。Go 客户端若写成 "localhost:9000"（无协议）或 "https://localhost:9000"（协议错配），必然连接失败。
- 本地开发未配 TLS 证书时，启动命令是
minio server /data，客户端 endpoint 必须是"http://localhost:9000"，且Secure: false - 若启用了 HTTPS（如用 Nginx 反代或自签证书），endpoint 得是
"https://minio.example.com:9000"，且Secure: true - MinIO 8.0+ 默认强制 TLS，本地没证书却设
Secure: true，会卡在 TLS 握手，日志里只看到context deadline exceeded或空响应
PutObject 上传大文件必须传可 seek 的 reader + timeout context
直接传 os.ReadFile(filename) 或 bytes.NewReader(data) 会让整个文件进内存，>100MB 就可能 OOM；不带 context 的 PutObject 默认无限等待，遇到连接池耗尽或 Keep-Alive 不匹配就会 hang 住。
立即学习“go语言免费学习笔记（深入）”；
- 用
os.Open打开文件，传*os.File—— SDK 内部会按需流式读取，支持自动 seek - 务必封装
context.WithTimeout(ctx, 5*time.Minute)，避免默认无限等待 -
contentType不能是空字符串，建议设为"application/octet-stream"或根据扩展名推断，否则某些 MinIO 版本会拒绝上传 - 桶名必须全小写、3–63 字符、不含下划线或点号开头，
"my-app/logs"是非法桶名，"myapp-logs"才合法
GetObject 返回后必须先检查 err，再读取，且记得 Close
GetObject 成功时返回 *minio.Object 和 err == nil，但对象不存在、权限不足、ETag 不匹配等情况，也可能返回非 nil 的 *minio.Object + err == nil，此时首次 Read 就 EOF 或 panic。
- 永远先判断
if err != nil，再处理obj - 读完必须
defer obj.Close()，否则 fd 泄露，压测时很快触发too many open files - 大文件别用
io.ReadAll(obj)，改用io.Copy(dstFile, obj)直接写入磁盘 - 如果上传时用了 multipart，下载时无需特殊处理——MinIO 自动合并，SDK 暴露的是完整流
最常被跳过的其实是探活和 reader 可重读性：前者让问题暴露在第一行日志里，后者决定你的服务在上传 2GB 日志时会不会 OOM 或超时。这两步漏掉，后面所有逻辑都建立在沙堆上。
