MinIO客户端panic因endpoint与SSL配置不匹配：本地开发需设secure:false且endpoint不带https://，生产环境需secure:true并确保证书有效；上传大文件须用带超时的context并确保文件句柄有效。
MinIO客户端初始化为什么总panic：endpoint和SSL配置不匹配
用 minio.New 初始化客户端时，如果传入的 endpoint 是 "localhost:9000" 却没关SSL，Go SDK会默认走HTTPS，结果连不上直接panic——错误信息通常是 "x509: certificate signed by unknown authority" 或直接 timeout。
实际场景里，本地MinIO服务默认不启用TLS，但SDK 7.0+ 版本起强制校验证书；生产环境启了TLS又容易漏掉 secure: true 参数，导致请求被重定向或拒绝。
- 本地开发：显式传
secure: false，endpoint别带https://前缀（比如用"localhost:9000"，不是"https://localhost:9000"） - 生产环境：确保
endpoint是域名（如"s3.example.com"），且secure: true，证书由权威CA签发或提前加载到Go的root cert pool - 调试技巧：用
curl -v http://localhost:9000/minio/health/live先确认服务可通，再写代码
PutObject上传文件卡住或报错io: read/write timeout
调用 minio.Client.PutObject 上传大文件（比如 >10MB）时，没设超时或没配好缓冲，容易在读取文件流阶段就卡死，或者返回 "context deadline exceeded"。
根本原因不是网络慢，而是默认的HTTP client没设timeout，底层TCP连接空等，尤其在容器或K8s里更明显；另外，传 *os.File 给 PutObject 时，如果文件没用 os.Open 打开、或已关闭，也会静默失败。
立即学习“go语言免费学习笔记（深入）”；
- 必须用带timeout的context：
ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)，传给PutObject - 文件句柄要有效：用
f, _ := os.Open("file.zip")，别用os.Stdin或已close的fd - 小文件（[]byte；大文件务必传
io.Reader，别先读进内存 - MinIO服务端默认单个对象上限是5TB，但客户端默认分块大小是5MB，上传超大文件建议调大
minio.PutObjectOptions.PartSize避免过多HTTP请求
GetObject下载时Content-Length为0或返回空数据
调用 minio.Client.GetObject 后，用 io.Copy 写文件，结果文件是空的，或者 resp.ContentLength 是0。常见于对象不存在、权限不足，或没正确处理response body。
MinIO不会在 GetObject 返回error时告诉你“对象不存在”，它只在HTTP状态码非200时才报错；而404、403都可能返回空body + 200以外的状态码，但Go SDK有时会吞掉细节。
- 永远检查
err：即使resp != nil，也要先看err != nil - 打印
resp.StatusCode和resp.Status（比如"404 Not Found"）快速定位是权限还是路径问题 - 别忽略
defer resp.Close()，否则后续请求可能复用脏连接，导致诡异的空响应 - 如果对象存在但内容为空，确认上传时没传空
io.Reader，或没设置ContentType导致某些客户端行为异常（虽不影响存储，但影响调试）
ListObjectsV2遍历大量对象性能差甚至OOM
用 minio.Client.ListObjectsV2 查10万+对象时，如果没分页或一次拉全量，内存暴涨、GC频繁，最后OOM。SDK默认不自动分页，listOptions 里的 MaxKeys 不设就是0，意味着“不限”，但底层其实是按1000条一批拉，反复拼接slice，内存翻倍增长。
更隐蔽的问题是：没设 Prefix 或 StartAfter，导致每次从头扫，重复读元数据；S3兼容层对前缀查询优化有限，纯靠服务端过滤。
- 必须设
MaxKeys: 1000（MinIO推荐值），并用listResp.NextMarker做游标分页 - 避免用
listOptions.Prefix = ""扫全桶；哪怕只是查日志，也尽量加时间前缀，如"logs/2024/06/" - 不要把所有
ObjectInfo存进一个大slice里处理，边list边处理（比如写入DB、触发事件） - 如果只是统计数量，用
minio.Client.StatObject配合已知key列表，比list快一个数量级
MinIO的S3 API兼容性很好，但Go SDK对错误码的包装偏弱，很多问题得靠抓包或看服务端日志才能准确定位。最常被忽略的是HTTP transport层的timeout和keep-alive配置——它们不在minio.Client里暴露，得自己构造 http.Client 传进去。
