不能直接用 c.SaveUploadedFile 传到腾讯云 COS，因其仅写入本地磁盘，存在磁盘爆满、无法扩展、无 CDN 和防盗链等问题，且多一次 I/O 和内存拷贝；应通过 cos.Client 的 PutObject 直传 io.Reader，或大文件用 InitiateMultipartUpload 分片上传。
为什么不能直接用 c.SaveUploadedFile 传到腾讯云 COS
因为 SaveUploadedFile 只会把文件写到本地磁盘，而生产环境上传必须走对象存储（如腾讯云 COS），否则存在磁盘爆满、无法横向扩展、无 CDN 加速、无防盗链等硬伤。直接保存再读取上传，等于多一次 I/O 和内存拷贝，还可能触发临时文件清理逻辑导致上传中断。
如何用 cos.Client 接收并直传 COS
核心是绕过本地落地，从 *multipart.FileHeader 中取出 file.Open() 得到的 io.Reader，直接交给腾讯云 SDK 的 PutObject 或 PutObjectWithContext。注意三点：
-
router.MaxMultipartMemory要设小（比如8 ），避免大文件全加载进内存 - 必须用
ctx.Request.MultipartForm或c.FormFile获取FileHeader，不能依赖c.PostForm - COS 的
PutObject第二个参数是io.Reader，不是文件路径，所以直接传file.Open()返回的 reader 即可
示例片段：
file, err := c.FormFile("file")
if err != nil {
c.JSON(400, gin.H{"error": "no file uploaded"})
return
}
src, err := file.Open()
if err != nil {
c.JSON(500, gin.H{"error": "failed to open file"})
return
}
defer src.Close()
_, err = cosClient.PutObject(context.TODO(), &cos.PutObjectOptions{
ObjectName: "uploads/" + file.Filename,
Reader: src,
})
if err != nil {
c.JSON(500, gin.H{"error": "upload to cos failed"})
return
}
c.JSON(200, gin.H{"url": "https://" + bucketName + ".cos." + region + ".myqcloud.com/uploads/" + file.Filename})
cos.Client 初始化时容易漏掉的关键配置
腾讯云 COS Go SDK（github.com/tencentyun/cos-go）初始化不只填 SecretId/SecretKey 就完事。以下三项漏一即报 403 Forbidden 或 400 InvalidArgument：
立即学习“go语言免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
-
Region必须是完整地域标识，比如ap-beijing，不能写成beijing或bj -
BaseURL要用https://<bucket>.cos.<region>.myqcloud.com格式，且bucket名不含-cos或.cos.后缀 - 若启用签名 V4（部分新地域强制），需显式设置
SignVersion: cos.VersionV4，否则默认 V2 签名失败
初始化示例：
cosClient := cos.NewClient(&http.Client{
Transport: &http.Transport{
MaxIdleConns: 100,
MaxIdleConnsPerHost: 100,
},
}, &cos.BaseURL{
BucketURL: "https://my-bucket-1250000000.cos.ap-beijing.myqcloud.com",
}, &cos.Authorization{
SecretID: os.Getenv("COS_SECRET_ID"),
SecretKey: os.Getenv("COS_SECRET_KEY"),
SignVersion: cos.VersionV4, // 关键！新地域必须
})
上传后如何生成带签名的临时 URL（防未授权访问）
COS 默认上传是公有读，但业务通常需要私有桶 + 临时授权 URL。别用前端拼接，必须服务端调用 SignURL：
-
SignURL第三个参数是过期秒数，建议控制在 300–3600 秒之间，太长易被滥用，太短影响用户体验 - 签名 URL 有效期与密钥权限无关，即使密钥已轮换，已签发的 URL 在过期前仍有效
- 若需限制 Referer 或 IP，得在 COS 控制台配 Bucket Policy，
SignURL不处理这些
生成方式：
signedURL, err := cosClient.Object.GetPresignedURL(
context.TODO(),
http.MethodGet,
"uploads/photo.jpg",
time.Hour*1, // 1 小时有效期
)
if err != nil {
c.JSON(500, gin.H{"error": "failed to sign url"})
return
}
c.JSON(200, gin.H{"signed_url": signedURL})
真正麻烦的是 multipart 上传大文件（>5MB）和断点续传——那得用 InitiateMultipartUpload + UploadPart + CompleteMultipartUpload 三步，不是简单 PutObject 能覆盖的。别图省事硬塞小文件逻辑，COS 控制台里看上传失败日志全是 EntityTooLarge 就晚了。
