用 minio-go sdk 连 minio 并上传文件：初始化客户端需 endpoint、accesskey、secretkey 和 secure 选项；桶需显式 makebucket 创建；上传用 putobject，传入 io.reader 并确保文件指针在开头。
怎么用 Go 连上 MinIO 服务并上传文件
MinIO 客户端在 Go 里不是用 net/http 手搓请求，而是依赖官方 SDK minio-go。它封装了签名、重试、分块上传等逻辑，直接拿它干活最稳。
常见错误是把 MinIO 当成普通 HTTP 服务去 http.Post，结果卡在签名失败或 403 —— MinIO 要求严格 V4 签名，SDK 自动处理，自己写几乎必错。
- 初始化客户端必须传
endpoint、accessKeyID、secretAccessKey，如果 MinIO 启用了 TLS（比如用 https），secure参数得设为true；本地开发常用http://localhost:9000+secure: false - 桶（bucket）不存在时，
MakeBucket不会自动创建，得显式调用，且只对新桶有效；已存在桶再调会报BucketAlreadyOwnedByYou - 上传对象用
PutObject，注意第三个参数是io.Reader，别传*os.File就完事——要确保文件指针在开头，否则上传空内容；建议用os.Open后立刻defer f.Close()
client, err := minio.New("localhost:9000", &minio.Options{
Creds: credentials.NewStaticV4("minioadmin", "minioadmin", ""),
Secure: false,
})
if err != nil {
log.Fatal(err)
}
// 上传
_, err = client.PutObject(context.Background(), "my-bucket", "hello.txt",
strings.NewReader("hello world"), -1, minio.PutObjectOptions{})
为什么 ListObjectsV2 返回空但桶里明明有文件
MinIO 的 ListObjectsV2 默认只列“一级前缀”，不递归，也不返回子目录（其实是对象键里的 / 分隔符）。你看到的“文件夹”只是键名习惯，MinIO 本身无目录结构。
典型表现：上传了 logs/2024/01/app.log，但 ListObjectsV2 不设参数就啥也不返回，或者只返回 logs/ 这种“伪目录”前缀。
立即学习“go语言免费学习笔记（深入）”；
- 要列出所有对象，必须传
minio.ListObjectsOptions{Recursive: true} - 如果只想看某路径下内容（如
logs/2024/），设Prefix: "logs/2024/"，同时Recursive: false可以只列这一层 - 注意
Prefix值结尾要不要加/：加了才匹配目录式前缀；不加可能匹配到logstash.json这种意外键
下载文件时内存爆掉或超时怎么办
GetObject 返回的是流式 minio.Object，底层是 io.ReadCloser。直接用 io.ReadAll 读大文件，等于全载入内存，1GB 文件就吃掉 1GB RAM，还可能触发 GC 压力或 context 超时。
- 小文件（io.ReadAll；大文件务必用流式处理：传给
io.Copy写磁盘，或用bufio.Scanner按行读日志类对象 - 务必设置
context.WithTimeout，尤其网络不稳定时；MinIO 默认无超时，卡住就一直 hang - 别忽略
Object.Close()：虽然io.Copy会关，但手动读取后忘记关会导致连接泄漏，后续请求变慢
obj, err := client.GetObject(context.Background(), "my-bucket", "big.zip", minio.GetObjectOptions{})
if err != nil {
log.Fatal(err)
}
defer obj.Close() // 关键
f, _ := os.Create("/tmp/big.zip")
defer f.Close()
io.Copy(f, obj) // 流式写，不占内存
为什么本地测试通，部署到 Kubernetes 就连不上 MinIO
不是代码问题，大概率是 DNS 或网络策略没对上。K8s Pod 里访问 MinIO 服务，不能硬写 localhost:9000，得用 Service 名称 + 端口，且要确认 Service 的 port 和 targetPort 匹配。
- 检查 MinIO Service 类型：如果是
ClusterIP，Pod 内用minio-svc.default.svc.cluster.local:9000；如果是NodePort或LoadBalancer，才考虑外网地址 - 确认 MinIO Pod 是否就绪：
kubectl get pods -l app=minio，状态不是Running就别试连接 - Go 应用容器里没有
curl？用nslookup minio-svc或telnet minio-svc 9000（需装 busybox）快速验证连通性 - MinIO 启用了 TLS 但 Go 客户端没配
Secure: true，或用了自签证书却没配http.DefaultTransport的TLSClientConfig，也会静默失败
真正麻烦的点不在代码，在 YAML 配置和集群网络拓扑——连不上先查 DNS 和端口，别急着改 Go 逻辑。
