Beego中调用OBS SDK前必须确认：项目已升级至v2.0.0+（Go 1.16+）、AK/SK通过环境变量或配置文件注入、Endpoint需显式指定，否则将导致连接异常、签名失败或403错误。
Beego中调用OBS SDK前必须确认的三件事
华为云OBS官方Go SDK（github.com/huaweicloud/huaweicloud-sdk-go-v3）不直接兼容Beego默认的HTTP客户端行为，硬塞进去会触发连接复用异常或签名失败。集成前必须确认：
- 你的Beego项目已升级到
v2.0.0+（要求Go 1.16+），旧版Beego 1.x 的beego.BeeApp.Handlers注入机制与SDK的中间件链冲突 - 华为云AK/SK必须通过环境变量（
HUAWEI_CLOUD_ACCESS_KEY/HUAWEI_CLOUD_SECRET_KEY）或配置文件注入，不能写死在代码里——OBS SDK v3 默认从这些位置读取凭据 - OBS的Endpoint需显式指定，例如华东-上海一区为
https://obs.cn-east-3.myhuaweicloud.com；Beego默认不处理区域域名拼接，漏写会导致403 Forbidden或InvalidEndpoint
上传文件时绕过Beego内置Multipart解析的必要性
Beego的 this.ParseForm() 和 this.Ctx.Input.RequestBody 会提前消费请求体，导致OBS SDK的流式上传（PutObject）读不到原始字节，报错 http: invalid Read on closed Body。正确做法是跳过Beego解析，直接接管原始流：
func (c *FileController) Upload() {
// 禁用Beego自动解析
c.Ctx.Input.DelStaticPath()
// 手动读取原始Body（注意：需控制大小，避免OOM）
body, err := io.ReadAll(c.Ctx.Request.Body)
if err != nil {
c.Data["json"] = map[string]string{"error": "read body failed"}
c.ServeJSON()
return
}
// 构造OBS client（示例使用临时凭证方式）
client := obs.New("your-access-key", "your-secret-key", "https://obs.cn-east-3.myhuaweicloud.com")
input := &obs.PutObjectInput{
Bucket: "my-bucket",
Key: "uploads/" + uuid.New().String() + ".bin",
Body: bytes.NewReader(body),
}
_, err = client.PutObject(input)
if err != nil {
c.Data["json"] = map[string]string{"error": err.Error()}
c.ServeJSON()
return
}
c.Data["json"] = map[string]string{"ok": "uploaded"}
c.ServeJSON()
}
Beego日志与OBS操作审计日志的对齐难点
OBS SDK自身不输出结构化操作日志（如PUT/GET耗时、返回码），而Beego的 beego.BeeLogger 又无法自动捕获SDK底层HTTP请求。若需审计，必须手动包装调用：
- 在每次
PutObject/GetObject前后打点，记录time.Now()和返回错误 - 将OBS的
obs.PutObjectOutput中的ResponseMetadata.RequestId注入Beego日志字段，方便追踪单次请求全链路 - 避免在Beego的全局Filter中统一拦截——OBS SDK走的是独立HTTP Client，Filter只作用于Beego路由层
大文件分片上传需自行管理Beego上下文生命周期
OBS支持 InitiateMultipartUpload → UploadPart → CompleteMultipartUpload 流程，但Beego的HTTP请求上下文（c.Ctx）在单次请求结束后即销毁。这意味着：
- 不能把
uploadId存在c.Data里传给下个请求——它不是跨请求的session - 必须用外部存储（Redis或本地文件）暂存分片状态，Key建议包含用户ID + 时间戳，防止冲突
- Beego的
SessionOn = true对OBS分片无意义，因为OBS本身不依赖Cookie做状态维持
最易被忽略的是超时控制：Beego默认ReadTimeout为60秒，而OBS分片上传可能持续数分钟。必须在 conf/app.conf 中显式加大：HttpServerTimeOut = 600，否则连接会在SDK完成前被Beego主动关闭。
