最稳路径是直接用 github.com/aliyun/aliyun-oss-go-sdk/oss，但需确保 endpoint 为纯 Region Endpoint（如"https://oss-cn-hangzhou.aliyuncs.com"）、AKSK 来自最小权限 RAM 子账号、上传显式设置超时及 context 超时，并严格校验文件与 region 一致性。
直接用 github.com/aliyun/aliyun-oss-go-sdk/oss 是最稳路径，但 endpoint 格式错、AKSK 权限过大、没设超时，三者任一出问题都会导致上传卡死、403 或跨区域失败。
endpoint 必须是纯 Region Endpoint，且带 https://
很多人从阿里云控制台复制「访问域名」直接塞进 oss.New()，比如 "https://my-bucket.oss-cn-hangzhou.aliyuncs.com"，这是错的——oss.New() 第一个参数只接受服务端点（Region Endpoint），不是 Bucket 域名。
- ✅ 正确写法：
"https://oss-cn-hangzhou.aliyuncs.com"（开头 https://，结尾无路径、无 bucket 名） - ❌ 错误示例：
"http://oss-cn-hangzhou.aliyuncs.com"→ HTTP 明文可能被拦截或拒绝 - ❌ 错误示例：
"https://my-bucket.oss-cn-hangzhou.aliyuncs.com"→ 报InvalidEndpoint或签名失败 - ❌ 错误示例：
"oss-cn-hangzhou.aliyuncs.com"→ 缺协议头，SDK 内部可能拼成http://导致 403
AKSK 必须来自 RAM 子账号，且权限最小化
主账号 AKSK 泄露 = 交出整个云账号控制权。生产环境绝不能硬编码主账号密钥，也别在 CI/CD 流水线里 commit。
- RAM 子账号策略必须精确到具体 Bucket，例如只允许
oss:PutObject、oss:GetObject、oss:DeleteObject和oss:ListObjects - 资源 ARN 写法必须是：
"acs:oss:*:*:your-bucket-name/*"（操作对象）和"acs:oss:*:*:your-bucket-name"（列举桶） - 推荐用环境变量加载：
oss.NewEnvironmentVariableCredentialsProvider()，配合OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET
上传必须显式设置超时，否则大文件会卡死 goroutine
bucket.PutObject() 和 bucket.PutObjectFromFile() 默认无超时，弱网或 OSS 响应慢时，HTTP 请求 hang 死，服务假死。
立即学习“go语言免费学习笔记（深入）”；
- 正确做法：调用时传
oss.Timeout(30 * time.Second)参数 - 如果上传大文件（>100MB），建议改用
bucket.PutObjectByFile()+oss.Routines(3)控制并发数 - 务必用
context.WithTimeout()包裹整个上传流程，避免 handler 长时间阻塞
Gin 中上传逻辑要分步校验，别一股脑扔给 OSS
常见错误是拿到 c.FormFile("file") 后直接 open 并上传，忽略文件大小、类型、空文件等边界情况，导致 OSS 调用失败后才返回错误，前端体验差。
- 先检查
file.Size是否超出限制（如 50MB），超限直接c.AbortWithStatusJSON(http.StatusBadRequest, ...) - 用
filepath.Ext(file.Filename)校验后缀，白名单过滤（如".jpg", ".png", ".mp4"） - 生成唯一文件名时，别只靠
time.Now().Unix()，要加uuid.NewString()防冲突 - 上传成功后，拼接的 URL 应为：
"https://" + bucketName + "." + endpointHost + "/" + fileName（注意 endpointHost 是去掉https://后的域名部分）
真正容易被忽略的是：OSS 的 endpoint 和你配置的 bucket 所在 region 必须严格一致，填错 region（比如 bucket 在杭州却配了北京 endpoint）会导致签名失败，错误信息往往只报 AuthorizationHeaderMalformed，不提示 region 不匹配。
