go cdk 无法直接统一多云对象存储，因其 blob.openbucket 对各云鉴权、区域、endpoint 差异化处理缺失，且国产云不兼容 aws s3 url 格式与签名机制。
直接用 go cdk 就能统一抽象，但实际落地时必须手动补足鉴权、区域、endpoint 三要素的差异化处理——不是所有云都支持 s3:// 形式 url，也不是所有 sdk 都默认读取环境变量。
为什么不能只靠 Go CDK 的 OpenBucket
Go CDK 的 blob.OpenBucket 看似开箱即用，但它对底层驱动的假设太强：比如 azureblob 要求 AZURE_STORAGE_CONNECTION_STRING 或显式传 account_name+account_key；gcsblob 默认走 ADC（Application Default Credentials），本地开发常因未 gcloud auth login 直接 panic；而 s3blob 虽支持 s3://bucket-name，但若用阿里云 OSS 或腾讯云 COS，就必须改写为 s3://bucket-name?endpoint=https://oss-cn-hangzhou.aliyuncs.com，且要额外注册自定义 HTTP 客户端才能绕过 AWS 签名兼容性问题。
常见错误现象：
-
failed to open bucket: unable to parse URL—— URL 格式不被驱动识别，尤其私有云或国产云没按 AWS S3 兼容层实现 -
signature does not match—— 用了 AWS SDK v2 的config.LoadDefaultConfig去连七牛云，签名算法和 header 规则完全不同 - 上传成功但文件不可访问 —— 没配对公有读策略（如 OSS 的
public-read）或 CDN 域名未绑定 bucket
aws-sdk-go-v2 兼容多云的关键配置点
用 aws-sdk-go-v2 接阿里云 OSS、腾讯云 COS、华为云 OBS，核心是覆盖 config.WithEndpointResolverWithOptions 和 config.WithCredentialsProvider，而不是依赖 region 自动推导。
实操建议：
- Endpoint 必须显式传入，例如阿里云杭州区：
https://oss-cn-hangzhou.aliyuncs.com；腾讯云广州区：https://cos.ap-guangzhou.myqcloud.com - credentials 提供器不能用
credentials.NewStaticCredentialsProvider硬编码密钥，应封装一层适配器，把七牛云的mac、又拍云的operator/password映射成aws.Credentials结构体 - signing name 必须设为
s3，但 signing region 可任意（OSS/COS 不校验 region，只认 endpoint），例如：config.WithRegion("oss-cn-hangzhou")是为了满足 SDK 初始化要求，实际无效 - 禁用
retryer默认行为，国产云返回的429或503错误码含义与 AWS 不同，需重写RetryableErrorFunc
七牛云 v7 SDK 的硬性约束必须手敲
七牛云 github.com/qiniu/go-sdk/v7 不接受任何路径简写，import 写错一个字符就编译失败。它和 AWS SDK 完全不兼容，必须单独封装。
容易踩的坑：
- token 生成必须带
PutPolicy{Scope: "bucket-name"}，漏掉Scope字段会导致401 Unauthorized - 上传接口严格区分
PutFile（传磁盘路径字符串）和Put（传[]byte），混用会把文件路径当内容上传 - 区域（
Zone）不能靠自动探测，storage.ZoneHuadong和storage.ZoneHuabei必须显式指定，否则在内网或代理环境下 token 生成失败 - 上传后必须检查
ret.Key和ret.Hash，部分元数据写入失败时err == nil，仅靠 error 判断会漏掉静默失败
统一接口设计时最易忽略的细节
定义 ObjectStorage 接口时，开发者常只关注 PutObject/GetObject，却忽略三类隐性差异：
- key 命名规则：七牛云不支持
/开头的 key（/a/b.txt会被截断），OSS 和 COS 支持但语义不同（OSS 中/a/b.txt和a/b.txt等价，COS 中前者是非法路径） - metadata 处理：AWS S3 的
x-amz-meta-前缀、OSS 的x-oss-meta-、七牛云的X-Qiniu-Meta-各自独立，统一接口若透传 metadata，必须做前缀映射 - 临时链接生成：S3 用
Presign+context.WithTimeout，七牛云用privateUrl+ 过期时间戳，又拍云需调用GetSignUrl，三者无法共用同一套签名逻辑
真正难的不是写通一个云，而是让所有云在边界条件（空 key、超长 key、含特殊字符的 filename）下返回一致的 error 类型和 message 格式——这需要大量手工 case 分支，没法靠抽象消除。
