华为云OBS完全兼容S3协议，可直接用aws-sdk-go-v2/service/s3对接，只需正确配置endpoint（带协议、不含bucket）、region（如cn-north-4）、signingName="s3"及IAM AK/SK；Gin中应全局初始化s3.Client并注入Context；上传时需注意ETag差异与超时控制。
直接用 aws-sdk-go-v2/service/s3 对接华为云 OBS
不用找华为云官方 Go SDK，也不用自己抽象 ObjectStorage 接口。华为云 OBS 完全兼容 S3 协议，aws-sdk-go-v2/service/s3 开箱即用，只需正确配置 endpoint、region 和签名参数。
常见错误是直接套用 AWS 的 region（如 us-east-1）或漏设 signingName，导致 403 Forbidden；或者把 bucket 名拼进 endpoint，触发 DNS 解析失败。
-
region必须填华为云文档中明确标注的 region ID，例如cn-north-4（华北-北京四），不能写“华北”或“北京” -
signingName必须显式设为s3，否则 SDK 会尝试用obs签名（华为云 OBS 不认这个） -
endpoint必须带协议（https://），且**不能含 bucket 名**；正确示例：https://obs.cn-north-4.myhuaweicloud.com，错误示例：https://my-bucket.obs.cn-north-4.myhuaweicloud.com - 凭证用华为云 IAM 的
Access Key ID和Secret Access Key，不是 AK/SK for OBS 子用户那种旧式密钥（已弃用）
在 Gin 中初始化 OBS 客户端并注入 Context
Gin 的 *gin.Context 本身不带全局状态，所以别把 client 塞进 c.Keys 或反复 new。推荐在启动时构建一次 *s3.Client，然后通过 gin.Engine.Use() 注入到所有请求上下文里。
示例代码片段：
立即学习“go语言免费学习笔记（深入）”；
cfg, err := config.LoadDefaultConfig(context.TODO(),
config.WithRegion("cn-north-4"),
config.WithCredentialsProvider(credentials.NewStaticCredentialsProvider(
"your-access-key-id",
"your-secret-access-key",
"",
)),
config.WithEndpointResolverWithOptions(
aws.EndpointResolverWithOptionsFunc(func(service, region string) (aws.Endpoint, error) {
return aws.Endpoint{URL: "https://obs.cn-north-4.myhuaweicloud.com"}, nil
}),
func(o *config.LoadOptions) { o.ResolveUnknownService = true },
),
)
if err != nil {
log.Fatal(err)
}
s3Client := s3.NewFromConfig(cfg)
r := gin.Default()
r.Use(func(c *gin.Context) {
c.Set("s3_client", s3Client)
c.Next()
})
后续 handler 中可安全取用：s3Client := c.MustGet("s3_client").(*s3.Client)。注意不要在中间件里做耗时操作（如 list buckets），避免阻塞请求流。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
上传文件时绕过华为云 OBS 的 ETag 差异陷阱
华为云 OBS 的 multipart upload 响应中，ETag 不是 MD5，而是形如 "<uuid>-<part_count>"</part_count></uuid> 的字符串。如果你业务依赖 ETag 校验完整性（比如前端传了 If-Match header），直接比对会失败。
解决方案分两种场景：
- 单 part 上传（
PutObject）：OBS 返回标准 MD5ETag，可直接用aws.CreateChecksum计算并校验 - 多 part 上传（
CreateMultipartUpload+UploadPart）：必须禁用 SDK 自动计算ETag，改用Content-MD5header 传入每个 part 的 MD5，再由 OBS 拼接生成最终 ETag —— 否则 SDK 会按 AWS 规则拼 MD5，和 OBS 不一致 - 若需服务端校验，建议改用
x-amz-checksum-sha256header（OBS 支持），比 ETag 更可靠
Gin 路由中调用 OBS 上传的最小可行封装
别把 S3 SDK 调用逻辑散落在各个 handler 里。建议抽一个轻量封装，只暴露 Upload 和 Delete 两个方法，参数聚焦业务语义（如 bucket、objectKey、reader），隐藏 region、endpoint 等配置细节。
关键点：
- 上传路径（
objectKey）必须做 URL-safe 编码，否则含空格或中文时 OBS 返回 400 - 务必设置
context.WithTimeout，OBS 在大文件上传时可能卡在某个 part 不响应，不设超时会导致 goroutine 泄漏 - 华为云 OBS 默认关闭 ACL，
PutObject时别传ACL: "public-read"，否则报错；如需公开访问，改用 bucket policy 或 CDN 回源配置 - 错误处理要区分网络错误（重试）、权限错误（403，需检查 AK/SK 和 IAM 权限）、资源错误（404，bucket 不存在）—— 这三类该返回的 HTTP 状态码完全不同
真正容易被忽略的是：华为云 OBS 的 ListObjectsV2 分页 marker 兼容性弱，ContinuationToken 仅在启用了 versioning 的 bucket 下才稳定；生产环境若需可靠分页，优先用 StartAfter + 字典序控制，别依赖 token。
