Golang实现文件上传到第三方云存储_Golang云开发实践-Golang-PHP中文网

endpoint必须带协议且不含bucket名，region可填任意非空字符串；MinIO不校验region但SDK签名依赖它，留空会失败，需显式配置signingName为"s3"避免403。

golang实现文件上传到第三方云存储_golang云开发实践

403 错误绝大多数不是权限没开，而是 endpoint 或 region 配得不对。MinIO 虽兼容 S3 API，但不走 AWS 的 region→endpoint 自动映射逻辑，必须显式、精确配置。

endpoint 必须带协议（http:// 或 https://），且不能包含 bucket 名 —— 错误示例：https://my-bucket.minio.local:9000；正确写法：http://localhost:9000
region 可填任意非空字符串（如 us-east-1），但必须传；MinIO 不校验 region 值，但 SDK 签名流程依赖它构造 header，留空会 panic 或静默失败
若用 aws-sdk-go-v2 接 MinIO，需显式设 signingName: "s3"，否则默认尝试用 minio 签名，直接 403
本地测试时，确保服务启用了 HTTPS（或关掉 TLS 验证），否则 Go 客户端可能因证书问题拒绝连接

这不是代码写错了，而是 multipart 表单没被正确解析，常见于前端漏写 enctype="multipart/form-data" 或后端未调用 r.ParseMultipartForm。

必须在 r.FormFile 前调用 r.ParseMultipartForm(32 ，参数是内存缓冲上限（单位字节）；设太小会导致大文件直接写临时文件，但 FormFile 仍能读取
如果表单字段名不是 "file"（比如前端写了 name="upload"），r.FormFile("file") 就必然返回 nil, err，错误信息是 no such file
调用 r.FormFile 后务必 defer file.Close()，否则文件句柄泄漏，上传大文件时很快 hit ulimit
注意：r.FormFile 返回的 file 是 io.ReadCloser，不能反复读；需要多次使用时先 io.ReadAll 或复制到 bytes.Buffer

默认上传走单次 PUT，超过服务端限制（如 Nginx 的 client_max_body_size）或网络抖动就会失败。MinIO 支持分块上传，但需主动启用。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

不要直接用 PutObject 传大文件，改用 PutObjectWithContext 并传入带超时的 context.Context
对 >5MB 文件，优先走 PutObject 的 multipart 模式：SDK 内部自动切片，但要求服务端支持 —— MinIO 默认开启，无需额外配置
上传前检查 handler.Size，避免把几百 MB 的文件全读进内存；用 file 流式传给 PutObject 即可
若用 aws-sdk-go-v2，需禁用自动 checksum（DisableContentMD5Validation: true），否则上传大文件时会额外计算 MD5，拖慢速度且可能 OOM

token 不是长期密钥，是有时效的一次性上传凭证，生成逻辑错或时间不同步都会导致失效。

invalid token 几乎 100% 是 token 过期（默认 3600 秒）或签名参数不匹配 —— 检查生成 token 时用的 bucket、key、deadline 是否与上传请求完全一致
服务器时间必须和七牛校验服务器时间误差 ntpdate -q time.windows.com 校时
上传时若指定 key（即文件名），token 必须用相同 key 生成；若传 nil 让七牛自动生成，则 token 里 key 也必须为 nil
别漏掉 mime 字段：七牛对部分类型（如视频）强制校验 MIME，前端没传或传错会静默失败，日志只报 invalid token