必须先调用makebucket创建桶，且检查返回错误是否为minio.errbucketalreadyownedbyyou以安全忽略；桶名须全小写、无下划线、长度3–63字符，region需统一。
上传文件到 MinIO 时 PutObject 报错 “NoSuchBucket” 怎么办
MinIO 不会自动创建 bucket，必须显式调用 MakeBucket，否则 PutObject 直接失败。常见错误是只写上传逻辑，漏掉 bucket 初始化。
- 先检查 bucket 是否存在：
client.BucketExists(ctx, "my-bucket")返回false就得建 - 建 bucket 要指定 region，MinIO 用
"us-east-1"即可（和 AWS 兼容但无实际地理含义） - 如果并发上传多个文件到同一 bucket，
MakeBucket只需执行一次，重复调用会报BucketAlreadyOwnedByYou，建议用if !exists { MakeBucket(...) }包一层
下载文件时 GetObject 返回空内容或 panic
GetObject 返回的是 *minio.Object，本质是个流式 reader，不读取就不会触发网络请求，也不会报错——所以“没内容”往往是因为忘了 io.Copy 或 io.ReadAll。
- 别直接打印
obj变量，它不是数据本身；要用defer obj.Close()+io.Copy(dst, obj) - 如果目标是内存字节，用
io.ReadAll(obj)，但注意大文件会吃光内存，生产环境应流式处理 - 务必检查
obj.Err()—— 它可能在读取中途才暴露 404 或权限问题，不是GetObject调用时就返回
用 PutObject 传大文件时卡住或超时
MinIO 默认使用分块上传（Multipart Upload），但 Go SDK 的 PutObject 是封装好的：小文件走单次 PUT，大文件自动切片。卡住通常源于网络或参数配置不当。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 设置合理的上下文超时：
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Minute)，尤其上传 GB 级文件 - 避免传入
nil的objectSize参数——SDK 无法预估长度时可能退化为 chunked 编码，某些代理或防火墙会拦截 - 若明确知道大小，传具体值（如
int64(fileStat.Size())），SDK 会启用更稳定的流式上传路径 - MinIO 服务端默认
max_multipart_size是 5 GiB，超出需改配置，但客户端无需改动
如何让上传下载支持断点续传和进度回调
SDK 原生不提供进度回调，但可通过包装 io.Reader 和 io.Writer 实现。关键不是改 MinIO 调用，而是控制数据流本身。
- 上传时：把原始文件 reader 包一层自定义
progressReader，每次Read()后更新计数器并通知回调 - 下载时：用
io.TeeReader(obj, progressWriter)或直接在io.Copy的 dst 里埋钩子 - 注意并发安全：进度变量要加
sync.Mutex或用atomic，尤其多文件同时传输时 - 不要在进度回调里做耗时操作（比如写磁盘日志），否则拖慢整个传输
MinIO 的 Go SDK 行为高度依赖你传进去的 context、objectSize 和 reader/writer 实现细节，很多“不工作”的问题其实出在流控逻辑或错误检查位置不对，而不是 API 用错了。
