minio.New初始化后client一调就panic，因为该函数仅做参数解析，不验证网络、权限或签名兼容性，返回client可能为nil；必须检查err，否则DNS失败、端口不通、TLS证书错、凭据大小写/空格不一致等问题均会导致后续调用panic。
minio.New 初始化后为什么 client 一调就 panic
因为 minio.New 只做参数解析，不验证网络、权限或签名兼容性。返回的 client 可能是 nil，但你没检查 err 就直接用了。
- 必须显式检查
err：DNS 失败、端口不通、TLS 证书错、凭据大小写/空格不一致，全在这里暴露，别用_忽略 -
endpoint只能是纯地址+端口，如"192.168.1.100:9000"，不能带http://或结尾/ - 本地开发默认走 HTTP，必须传
secure: false；生产启 TLS 后才设true，错配会卡在 EOF 或空响应 -
accessKey和secretKey必须和 MinIO 启动时环境变量（如MINIO_ROOT_USER）值完全一致——大小写、空格、换行都算
BucketExists 和 MakeBucket 怎么配合才不崩
桶创建不是幂等操作，MakeBucket 重复调用已存在的 bucket 会返回 minio.BucketAlreadyOwnedByYou 错误，而不是静默跳过——微服务重启时极易 panic。
- 必须先调
client.BucketExists(ctx, "my-bucket")，再根据返回的exists布尔值决定是否MakeBucket -
BucketExists自身也可能出错（网络超时、权限不足），不能只看exists，要同时检查err - 桶名必须 DNS 兼容：全小写、不含下划线、不以点开头/结尾、长度 3–63 字符；
"my-app/logs"是非法名，路径属于 object key - 若
MakeBucket指定了 region（如"us-east-1"），后续所有操作必须用同一 region，否则某些版本会静默失败
大文件上传卡住或 OOM 的真实原因和解法
用 os.ReadFile 加载几百 MB 文件再传给 PutObject，等于把整个内容塞进内存，GC 压力陡增，甚至 OOM；而直接传 *os.File 又可能因 offset 未重置导致第二次上传读 EOF。
- 打开文件后直接传入
PutObject：file, _ := os.Open("large.zip")→client.PutObject(ctx, "bucket", "large.zip", file, -1, ...) - 第四个参数设为
-1表示长度未知，SDK 自动按 5MB 分块；弱网环境可显式控制分片：minio.PutObjectOptions{PartSize: 64 * 1024 * 1024} - 务必传带超时的
context.Context：ctx, cancel := context.WithTimeout(context.Background(), 5*time.Minute)，否则 multipart 初始化卡住无感知 - 上传完成后检查返回的
minio.UploadInfo.Size是否等于源文件file.Stat().Size()，防止网络中断导致静默截断
为什么 GetObject 返回的 Reader 读不到数据
最常见原因是没检查 err 就直接读 obj.Object。MinIO 在对象不存在、权限不足、ETag 不匹配等场景下，会返回一个“假成功”的 minio.Object，但底层 Read() 会立即返回 EOF 或空。
立即学习“go语言免费学习笔记（深入）”；
- 必须先检查
err：obj, err := client.GetObject(ctx, "bucket", "key", minio.GetObjectOptions{})，err != nil 时绝对不要碰 obj - 即使
err == nil，也要确认obj非 nil，再调io.Copy或io.ReadAll - 预签名 URL 失效快？大概率是 Go 服务和 MinIO 服务器系统时间不同步，或生成时用了本地
time.Now()但没考虑时区 - HTTP 连接池耗尽也会表现为 GetObject 卡住：MinIO Server 默认
max_idle_connections=50，短生命周期服务（如 K8s Job）高频复用 client 时容易触达上限
实际部署时，最容易被忽略的是：客户端初始化后没立刻探活。哪怕只调一次 client.ListBuckets，也能提前暴露认证失败、签名不兼容（比如老服务端只认 v2 签名）、TLS 握手失败等问题——这些错误全藏在第一次真实请求里，不在 minio.New 阶段报。
