最稳妥的minio上传方式是直接用minio-go sdk调putobject，需确保签名正确、桶有postobject权限、大文件启用multipart支持；不可用c.saveuploadedfile，因其仅写本地磁盘。
直接用 minio-go SDK 调 PutObject 是最稳妥的上传方式，但别跳过签名、桶权限和 multipart 分片这三关——否则小文件能传，大文件必卡死或 403。
为什么不能直接用 c.SaveUploadedFile 存 MinIO？
因为 c.SaveUploadedFile 只写本地磁盘，它底层调的是 os.Create + io.Copy，和 MinIO 完全无关。你得把文件流交给 minio.Client.PutObject，而不是先落地再读取。
- 常见错误：先
c.SaveUploadedFile(file, "/tmp/xxx")，再os.Open("/tmp/xxx")传给 MinIO —— 多一次磁盘 IO，大文件易 OOM - 正确姿势：用
file.Open()拿到io.Reader，直接喂给minioClient.PutObject - 注意
file.Size可能为 -1（浏览器未发送 Content-Length），此时PutObject会退化为 multipart 上传，必须确保桶启用了 multipart 支持
minio-go 的 PutObject 参数怎么填才不报错？
PutObject 看似简单，但四个参数缺一不可，且顺序和类型容易搞混：
-
bucketName string：必须已存在，且你的 AccessKey 对该桶有Write权限（MinIO 控制台或mc命令确认） -
objectName string：建议带路径前缀（如"uploads/avatar/" + uuid.New().String() + ".jpg"），避免根目录堆积 -
reader io.Reader：来自file.Open()，不是file本身；别漏defer in.Close() -
objectSize int64：必须传真实大小，不能写0或-1；若不确定，用file.Size，为 -1 时改用PutObjectWithContext+minio.PutObjectOptions{ContentType: "..."}
示例片段：
in, _ := file.Open()
defer in.Close()
_, err := minioClient.PutObject(context.Background(), "my-bucket", "uploads/"+file.Filename, in, file.Size, minio.PutObjectOptions{
ContentType: file.Header.Get("Content-Type"),
})
前端直传 MinIO 为什么总提示 SignatureDoesNotMatch？
这不是 Gin 的问题，是签名逻辑没对齐。MinIO 兼容 S3 签名 v4，但默认只开 HTTP POST 表单直传（PresignedPostPolicy），不是 GET 预签名 URL。
- 错误做法：用
PresignedGetObject生成上传链接 —— 这是下载用的，上传会 403 - 正确做法：服务端调
minioClient.PresignPostPolicy，返回url+fields给前端，前端用FormData提交到该url - 关键字段：
fields["key"]必须和策略里声明的一致；fields["policy"]和fields["signature"]由 SDK 生成，前端不能手拼 - 桶策略需显式允许
PostObject，例如：{"Effect":"Allow","Action":["s3:PostObject"],"Resource":["arn:aws:s3:::my-bucket/*"]}
大文件上传卡在 10MB 就超时？
Gin 默认读取 body 限时 30 秒、最大 32MB，而 MinIO 的 multipart 上传可能耗时更久。两个地方要同步调大：
- Gin 层：启动时加
gin.SetMode(gin.ReleaseMode)，再用r.MaxMultipartMemory = 1024 * 1024 * 100 // 100MB - HTTP 服务层：用
http.Server显式设置ReadTimeout和WriteTimeout，例如srv := &http.Server{Addr: ":8080", Handler: r, ReadTimeout: 5 * time.Minute, WriteTimeout: 5 * time.Minute} - MinIO 侧：确认
MINIO_REGION和客户端时区一致，时间偏移超过 15 分钟也会触发签名失效
真正难缠的是分片合并失败——MinIO 不会自动清理临时分片，上传中断后残留的 uploads/xxx 会一直占空间，得靠定时任务或监听 minio-go 的 CompleteMultipartUpload 结果来兜底。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
