gin 不应直传云存储，而应中转校验后上传；c.formfile("file") 返回 nil 主因是请求头或表单字段名不匹配，且需注意 curl 不要手动设 multipart header、formdata 字段名须一致、调整 maxmultipartmemory。
直传云存储不是 Gin 该干的事，Gin 做中转更安全、可控、可审计。前端直传 OSS/COS/S3 虽然省带宽，但必须暴露临时 token 或签名逻辑，一旦密钥泄露或策略配置宽松，等于把 bucket 权限拱手让人。生产环境建议用 Gin 接收 → 校验 → 上传云服务，而不是让前端直接对接。
为什么 c.FormFile("file") 总是返回 nil？
这是最常卡住的第一步。根本原因不是代码写错，而是 HTTP 请求头或表单构造违规：
- 用
curl测试时，绝对不要加-H "Content-Type: multipart/form-data"——--form会自动设置正确 header 并生成 boundary，手动指定反而破坏格式 - 前端用
FormData时，字段名必须和后端c.FormFile("xxx")的字符串完全一致（比如后端写"file"，前端就得formData.append("file", fileInput.files[0])） - Gin 默认内存限制是 32MB，上传大图前要显式调小缓存：在路由初始化处加
router.MaxMultipartMemory = 16 （16MB），否则超限直接丢弃整个 form
如何安全地命名和保存临时文件？
别直接用 header.Filename，它可能含 ../ 或非法字符，导致路径遍历或覆盖系统文件：
- 用
path.Base(header.Filename)截掉路径部分，再用strings.ToLower(path.Ext())统一后缀小写 - 生成唯一文件名：推荐
fmt.Sprintf("%d-%s%s", time.Now().UnixNano(), uuid.NewString()[:8], ext)，避免时间戳碰撞 - 保存前确保目录存在：
os.MkdirAll("uploads/", 0755)，否则c.SaveUploadedFile()会静默失败 - 如果只是中转不落地，可用
file.Open()直接读取流上传云服务，跳过本地磁盘写入，减少 I/O 和清理负担
上传到腾讯云 COS / 阿里云 OSS / AWS S3 的关键差异点
三家 SDK 调用流程相似，但鉴权方式和参数名容易混淆：
- COS：依赖
github.com/tencentyun/cos-go-sdk-v5，SecretID和SecretKey是主账号密钥（开发期可用），生产务必用临时密钥Token字段 - OSS：用
github.com/aliyun/aliyun-oss-go-sdk/oss，Endpoint必须带协议（如https://oss-cn-hangzhou.aliyuncs.com），漏掉https://会导致连接被重定向失败 - S3：AWS SDK v2 中
config.LoadDefaultConfig()会读取环境变量或~/.aws/credentials，但 Gin 服务通常容器化部署，建议显式传入credentials.NewStaticCredentialsProvider(key, secret, "")，第三个参数token在使用临时凭证时才填 - 所有上传都需设置
ContentType，否则云服务可能识别为binary/octet-stream，导致浏览器下载而非预览图片 —— 从header.Header.Get("Content-Type")获取， fallback 到mime.TypeByExtension(ext)
真正麻烦的不是上传动作本身，而是错误处理链路：文件损坏、网络中断、云服务限流、临时凭证过期……这些异常不会立刻报错，可能在 PutObject 返回后几秒才触发 context timeout 或 connection reset。建议上传后主动调用 HeadObject 验证 key 是否真实存在，再返回前端链接。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
