minio.New初始化后必须立即调用client.BucketExists或client.ListBuckets探活，因它仅解析参数、不验证网络/权限/签名；HTTPS需设secure=true，HTTP则为false，错配导致EOF；BucketExists对不存在桶返回false,nil，但权限、超时、签名错误均返回err!=nil。
minio.New 初始化后必须立刻探活，否则连接失败不报错
很多人以为 minio.New 返回非 nil 的 client 就代表连上了，其实它只做参数解析，不发任何网络请求。endpoint 写错、TLS 配置反了、AccessKey 权限不足、服务端禁用 v2 签名……全都不会在初始化时暴露。
必须紧接着调用一次实际请求来“探活”，推荐用 client.BucketExists（哪怕传个不存在的桶名）或 client.ListBuckets：
- 如果 endpoint 是 HTTPS 地址，
Secure必须为true；HTTP 则必须为false，错配会导致 EOF 或空响应 -
BucketExists在桶不存在时返回false, nil，但权限错误、网络超时、签名不匹配等都会返回err != nil - 别用
MakeBucket替代探活——它在桶已存在时会返回minio.BucketAlreadyOwnedByYou错误，不是幂等操作
PutObject 上传卡住或报 context deadline exceeded 的真实原因
这不是 SDK bug，而是 HTTP 连接池 + 服务端 Keep-Alive 配置不匹配导致的静默 hang，尤其在短生命周期服务（如 K8s Job、Lambda）里高频复用 client 时极易复现。
关键点不在文件大小，而在上下文和 reader 的使用方式：
立即学习“go语言免费学习笔记（深入）”；
- 务必传入带 timeout 的
context.Context：例如ctx, cancel := context.WithTimeout(context.Background(), 5*time.Minute) - 避免直接传
[]byte或os.ReadFile结果——大文件会全量进内存，可能 OOM；改用os.Open后传 *os.File，SDK 内部会按需流式读取 - 若用
bufio.NewReader包装 reader，注意它不支持重读；上传失败重试前需确保能Seek(0, 0) -
contentType参数不能是空字符串，建议设为"application/octet-stream"或根据扩展名推断
GetObject 返回空数据或 EOF 的常见误操作
GetObject 返回的是 *minio.Object，本质是流式 io.ReadCloser。不检查 err 就直接读，90% 的“读不到”问题都源于此。
对象不存在、权限不足、ETag 不匹配、甚至服务端临时故障，都可能让 GetObject 返回非 nil 的 *minio.Object + err == nil，但后续 Read 立即 EOF 或 panic。
- 永远先判断
err：即使obj != nil，只要err != nil就不该继续读 - 读完必须
defer obj.Close()，否则 fd 泄露，压测时容易触发 “too many open files” - 别对大文件用
io.ReadAll(obj)，改用io.Copy(dst, obj)写入*os.File - 需要断点续传？用
obj.Stat().Size获取大小，再配合GetObjectOptions{Range: "bytes=1000000-"}手动 Seek
Bucket 名称和 region 设置的硬性限制
MinIO 对 bucket 名和 region 的要求比 AWS S3 更严格，填错会直接返回 error，且错误信息不直观。
- bucket 名必须全小写、3–63 字符、仅含字母、数字、连字符（
-），不能有下划线或点号；"my_app"、"My-Bucket"、"a.b.c"全非法 -
MakeBucket的 region 参数目前**只接受"us-east-1"**，填其他值（包括空字符串）会失败 - MinIO 不支持嵌套桶，
"app/logs"是非法桶名，只能建"app"桶，把对象路径设为"logs/file.txt" - 上传前必须确认桶存在：
BucketExists→ 不存在则MakeBucket，不能跳过这步
最易被忽略的其实是探活时机和 bucket 名校验——这两步漏掉，后续所有操作都在“假装正常运行”，直到某个深夜上传失败才发现 endpoint 根本不通，或者桶名因含大写字母被静默拒绝。细节不处理，就不是配置问题，是架构隐患。
