直接用 aws-sdk-go-v2/service/s3 就够了，无需自定义 ObjectStorage 接口；关键在于正确配置 endpoint、region、credentials 和 signingName，配合 WithEndpointResolverWithOptions 与 ResolveUnknownService=true 绕过默认映射，即可统一支持 AWS/OSS/COS/OBS/MinIO。
直接用 aws-sdk-go-v2/service/s3 就够了，别自己定义 ObjectStorage 接口
你不需要抽象出 PutObject、GetObject 这类接口再为 AWS/OSS/COS/OBS/MinIO 各写一遍实现——80% 的重试逻辑、context 取消、分块上传状态管理都重复，但错误码映射、ETag 计算方式、元数据 key 大小写又得各自 patch。更麻烦的是，某家云升级签名 header 规则，你得同步改三处。
aws-sdk-go-v2/service/s3 本身已覆盖绝大多数 S3 兼容服务行为。你写的不是“适配器”，是“配置驱动的 S3 客户端”。关键就四件事：endpoint、region、credentials、signingName 对齐即可。
-
region必须填文档 ID（如阿里云填oss-cn-hangzhou，不能填 “华东1”） -
signingName显式设为s3，哪怕对接 OSS，否则 SDK 会尝试用oss签名，直接返回403 Forbidden -
endpoint必须带协议（https://），且不能含 bucket 名（错例：https://my-bucket.oss-cn-hangzhou.aliyuncs.com→ 正确：https://oss-cn-hangzhou.aliyuncs.com） - 上传大文件时禁用自动 checksum（
DisableContentMD5Validation: true），或优先走原生client.PutObject，避免 SDK 在分块上传中误加x-amz-checksum-sha256导致 COS/OBS 拒绝
绕过默认 endpoint 映射，用 WithEndpointResolverWithOptions 强制指定
config.LoadDefaultConfig 默认按 region 查 AWS 官方映射表，根本不会识别 oss-cn-hangzhou 这种非 AWS region。必须用 config.WithEndpointResolverWithOptions 手动接管 endpoint 解析，并开启 ResolveUnknownService = true，否则 SDK 会因不认识 s3 服务在该 region 而 panic。
示例（阿里云 OSS）：
立即学习“go语言免费学习笔记（深入）”；
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
cfg, err := config.LoadDefaultConfig(context.TODO(),
config.WithRegion("oss-cn-hangzhou"),
config.WithCredentialsProvider(credentials.NewStaticCredentialsProvider(
"AK", "SK", "")),
config.WithEndpointResolverWithOptions(
aws.EndpointResolverWithOptionsFunc(func(service, region string) (aws.Endpoint, error) {
return aws.Endpoint{URL: "https://oss-cn-hangzhou.aliyuncs.com"}, nil
}),
func(o *config.LoadOptions) {
o.ResolveUnknownService = true
}),
)
- 不要把 bucket 塞进
URL，bucket 是PutObjectInput.Bucket字段传的 -
WithRegion仅用于签名和部分 header 构造（如X-Amz-Date），不参与 DNS 解析 - 腾讯云 COS 的
endpoint是https://cos.ap-beijing.myqcloud.com，华为云 OBS 是https://obs.cn-east-2.myhuaweicloud.com，全部按此模式填
注意各家云在 checksum、ETag、分块大小上的实际差异
SDK 默认对 PutObject 请求计算并附加 Content-MD5，但阿里云 OSS 不校验该头，COS 要求值为 base64(MD5)，OBS 则完全忽略；ETag 在分块上传后，OSS 返回的是 "xxx-xxx" 格式，COS 返回 "xxx"，MinIO 返回 "xxx" —— 这些细节直接影响你是否能用统一逻辑校验上传完整性。
- 禁用自动 checksum：在
PutObject调用时显式传options.WithAPIOptions(transport.DisableContentMD5Validation()) - 分块上传大小建议固定为 5MB（OSS/COS/OBS/MinIO 都支持），避免 MinIO 默认 64MB 在某些云上触发 400 错误
- ETag 校验逻辑不能依赖
resp.Result.ETag直接比对，需先 strip 引号再判断是否含-（分块上传标识） - 403 错误大概率来自时间偏移（
X-Amz-Date与服务端差超 15 分钟）、Hostheader 不匹配（endpoint 带 bucket 就崩）、或 RAM 权限没精确到oss:PutObject粒度
初始化客户端时别漏掉 ResolveUnknownService = true
这个开关不打开，config.LoadDefaultConfig 在遇到非 AWS region（比如 oss-cn-hangzhou）时，会因无法将 s3 服务映射到该 region 而直接 panic，错误信息类似 failed to resolve service endpoint for "s3" in region "oss-cn-hangzhou"。它不是可选优化项，是多云接入的硬性前提。
很多人卡在这一步，反复检查 endpoint 和 region 拼写，却忘了在 WithEndpointResolverWithOptions 的 options 闭包里设 o.ResolveUnknownService = true。这个字段控制 SDK 是否允许 fallback 到自定义 resolver，而不是死在 region 映射阶段。
真正容易被忽略的点在于：它必须和 WithEndpointResolverWithOptions 成对出现，单独设 WithRegion 或只改 endpoint 都无效。一旦漏掉，整个模块连初始化都失败，更别说后续调用了。
