必须用HTTPS协议且地域匹配，Endpoint须为https://oss-cn-hangzhou.aliyuncs.com等格式；AccessKey必须用RAM子用户并授予最小权限；大文件须用分片上传，避免PutObject直接上传超100MB文件。
初始化OssClient时Endpoint协议必须用https
很多Gin项目启动后调用CreateBucket或PutObject直接报403 Forbidden或connection refused，根本原因常是Endpoint写成了http://oss-cn-hangzhou.aliyuncs.com。阿里云OSS自2023年起强制HTTPS，HTTP endpoint已不可用。
正确写法必须带https://前缀，且地域要和Bucket创建地一致：
-
https://oss-cn-hangzhou.aliyuncs.com（杭州） -
https://oss-cn-shanghai.aliyuncs.com（上海） -
https://oss-cn-beijing.aliyuncs.com（北京）
如果用错，oss.New()不会立即报错，但后续所有操作都会失败——错误藏在第一次实际请求里，排查时容易误判为权限或网络问题。
AccessKey不能用主账号，必须用RAM子用户
Gin服务部署后长期运行，一旦主账号AccessKeyId和AccessKeySecret泄露，等于交出整个阿里云控制台权限。线上环境必须用RAM子用户，并只授予最小必要权限。
具体操作要点：
- 登录RAM控制台 → 用户管理 → 创建用户 → 勾选「编程访问」
- 授权策略选
AliyunOSSReadOnlyAccess（只读）或AliyunOSSFullAccess（读写），**不要选AdministratorAccess** - 创建后立刻复制
AccessKeySecret，关闭页面就再也看不到——SDK初始化失败时若打印密钥，会直接暴露
常见坑：本地调试用主账号AK能通，一上ECS就403。因为ECS安全组或VPC路由可能拦截了主账号AK的高危调用，而RAM子用户权限受控，反而更稳。
上传大文件要用分片上传，别硬扛PutObject
直接用client.PutObject()传超过100MB的文件，在Gin HTTP handler里容易触发超时、内存溢出或连接中断。OSS Go SDK提供PutObjectFromFile()和分片上传接口，后者才是生产标配。
推荐做法：
- 小文件（PutObject()，简单直接
- 中大文件（5MB–5GB）：用
PutObjectFromFile()，自动分片+断点续传 - 超大文件（>5GB）：手动调用
InitiateMultipartUpload+UploadPart+CompleteMultipartUpload
注意：PutObjectFromFile()内部会打开文件流并缓冲，如果Gin用的是默认gin.Default()，其MaxMultipartMemory默认仅32MB，需提前调大：
r := gin.Default() r.MaxMultipartMemory = 1024 << 20 // 1GB
生产部署必须加超时和重试，别信默认值
OSS SDK的oss.Timeout和oss.RetryPolicy默认值极宽松（比如超时30秒、重试10次），放在Gin里会导致HTTP请求卡住、goroutine堆积、服务假死。
上线前务必显式配置：
-
oss.Timeout(10 * time.Second, 30 * time.Second)（连接10秒，读写30秒） -
oss.RetryPolicy(oss.RetryN(3))（最多重试3次） - 若部署在ECS同地域，优先用内网Endpoint（如
https://oss-cn-hangzhou-internal.aliyuncs.com），省流量、降延迟
最容易被忽略的一点：Gin的c.Request.Context()生命周期和OSS请求不绑定。如果用户中途关闭浏览器，OSS上传还在后台跑，既浪费资源又难监控。应在handler里监听c.Request.Context().Done()，主动取消OSS操作。
