MinIO客户端初始化报invalid endpoint错，主因是endpoint含协议头或尾部斜杠；须用纯主机名+端口格式，如"127.0.0.1:9000"，且accessKey/secretKey需匹配服务端配置。
MinIO客户端初始化为什么总报错 invalid endpoint
常见原因是传入的 endpoint 包含了协议头或尾部斜杠。MinIO SDK（minio-go）要求 endpoint 是纯主机名+端口格式，比如 "play.min.io" 或 "127.0.0.1:9000"，不能是 "http://127.0.0.1:9000" 或 "localhost:9000/"。
初始化时还要注意：
-
accessKey和secretKey必须与 MinIO 服务启动时配置的一致（默认是"minioadmin"/"minioadmin"） - 若连接本地 MinIO，且启用了 HTTPS（如用 TLS 证书），需显式传入
true作为第四个参数：minio.New("127.0.0.1:9000", "minioadmin", "minioadmin", true) - Go 模块未正确引入？确认已执行
go get github.com/minio/minio-go/v7（v7 是当前主流稳定版）
上传文件时如何避免内存爆掉（大文件场景）
直接用 PutObject 传 *os.File 或 []byte 对小文件没问题，但对几百 MB 以上的文件，会把整个内容读进内存，触发 GC 压力甚至 OOM。正确做法是用 PutObject 的流式接口，传入 io.Reader 并控制分块大小。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 打开文件后，直接传给
PutObject，不要os.ReadFile全量加载：file, _ := os.Open("big.zip")→client.PutObject(ctx, "mybucket", "big.zip", file, -1, minio.PutObjectOptions{ContentType: "application/zip"}) - 第四个参数设为
-1表示“未知长度”，SDK 会自动按 5MB 分块（可接受）；若想自定义分块，用minio.PutObjectOptions{PartSize: 10*1024*1024} - 务必检查返回的
minio.UploadInfo中的Size字段，确认上传字节数是否匹配源文件Stat().Size()，防止因网络中断导致静默截断
下载文件怎么支持断点续传和进度回调
MinIO Go SDK 本身不内置断点续传逻辑，但提供了底层支持：通过 GetObject 返回的 *minio.Object 实现了 io.ReadSeeker，你可以手动 Seek 到指定 offset 继续读。
要实现带进度的下载：
- 先用
StatObject获取文件总大小：stat, _ := client.StatObject(ctx, "mybucket", "data.bin", minio.StatObjectOptions{}) - 调用
GetObject得到对象句柄，再用io.Copy配合自定义的io.Writer（在Write方法里更新进度） - 如果需要真正断点续传（比如中途失败后从上次位置继续），得自己维护 offset 并用
GetObject的minio.GetObjectOptions{Range: "bytes=1000000-"}显式指定范围 - 注意：S3 协议标准中
Range请求要求服务端返回206 Partial Content，MinIO 支持，但某些代理或 CDN 可能吞掉该状态码，导致行为异常
为什么 ListObjects 返回空，但控制台能看到文件
最常见两个原因：前缀（prefix）拼写错误、或桶名大小写不一致。MinIO 的 bucket 名是 DNS 兼容的，强制小写，而对象 key 是大小写敏感的。
排查要点：
- 确认
ListObjects调用时传的bucketName全小写，比如"mylogs"，而不是"MyLogs" - 检查
minio.ListObjectsOptions.Prefix是否多写了开头斜杠，例如"/images/"应为"images/" - 如果只想要一级目录结构（类似 ls），需设置
Delimiter: "/"，否则它默认递归列出所有嵌套 key - 注意
ListObjects默认只返回最多 1000 个对象，超过需用ContinuationToken分页，v7 SDK 中对应StartAfter参数
很多问题出在「以为路径语义和本地文件系统一样」——MinIO 里根本没有目录概念，"a/b/c.txt" 就是一个完整 key，Delimiter 只是字符串切分逻辑，不是真实目录层级。
