应避免硬套统一ObjectStorage接口，因其强行抹平各云语义差异，导致map[string]interface{}滥用、错误码漏判及维护成本飙升；推荐复用aws-sdk-go-v2/service/s3驱动S3兼容服务（如MinIO、OSS、COS），GCP则必须单独使用cloud.google.com/go/storage实现隔离。
别自己定义 ObjectStorage 接口
硬套一个统一接口看似干净，实际会把各云的语义差异强行抹平，最终变成一堆 map[string]interface{} 和条件判断。AWS S3 的 ServerSideEncryption、Aliyun OSS 的 oss.ServerSideEncryption、GCP 的 EncryptionKey 不仅字段名不同，生效时机、取值范围、是否强制校验也全不一样。错误码更没法对齐：s3.ErrCodeNoSuchBucket 和 oss.ErrNoSuchBucket 是两个独立类型，强转或字符串匹配都容易漏判。
更现实的问题是维护成本：某家云升级签名逻辑（比如 OSS 2026 年 7 月起要求 X-Oss-Date 精确到毫秒），你得改三处——SDK 初始化、上传路径、预签名生成——还容易只改了两处。
优先复用 aws-sdk-go-v2/service/s3 驱动多云
MinIO、阿里云 OSS、腾讯云 COS、华为云 OBS 都是 S3 兼容服务，aws-sdk-go-v2/service/s3 本身就能跑通，关键在配置：
-
config.WithRegion必须填官方文档指定的 region ID（如oss-cn-hangzhou），不能写“华东1”这类中文别名 -
config.WithEndpointResolverWithOptions强制指定 endpoint，且 URL 必须带协议（https://oss-cn-hangzhou.aliyuncs.com），不能含 bucket 名 -
config.WithCredentialsProvider传静态密钥，但 GCP 除外——它不认 access key，必须靠GOOGLE_APPLICATION_CREDENTIALS环境变量加载 service account key -
signingName显式设为s3，否则 SDK 可能尝试用oss或cos签名，直接 403
这种做法把“适配器”变成了“配置驱动的客户端”，80% 的重试、超时、context 取消逻辑由 SDK 自己处理，你只管填对参数。
立即学习“go语言免费学习笔记（深入）”；
PresignedPutURL 是最该隔离的点
各家对预签名 URL 的约束差异极大，根本没法统一参数：
- AWS：
s3.PresignPutObject的Expires是time.Duration，最小 15 分钟，否则报SignatureDoesNotMatch - Aliyun OSS：
bucket.SignURL的expires是 int 秒，最大 64800（18 小时），超限返回InvalidArgument - GCP：不支持客户端直签，必须走
storage.SignedURLOptions+ IAM service account key，且有效期上限 12 小时
别试图在上层封装一个 GeneratePresignedPutURL(key string, expires time.Duration)。直接在 adapter 层拆成两版：GeneratePresignedPutURLV1（S3/OSS 兼容）和 GeneratePresignedPutURLV2（GCP 专用）。调用方按云厂商选函数，参数含义明确，不会因精度截断或时区偏移出错。
GCP 必须单独走 cloud.google.com/go/storage
它和 S3 生态完全不兼容，不是 endpoint 换个地址就能用。认证依赖 GOOGLE_APPLICATION_CREDENTIALS 环境变量指向 JSON key 文件，不能模拟 access key；API 调用路径、元数据字段命名、分片上传流程（无 multipart upload 概念）、甚至 ETag 计算方式都自成体系。
如果你的业务必须支持 GCP，就老老实实引入 cloud.google.com/go/storage，写一个独立的 GCSStorage struct，实现和 S3 客户端一致的 PutObject/GetObject 方法签名——但内部逻辑完全隔离。混用 SDK 或强行塞进 S3 配置只会让错误日志变得无法归因。
真正难的不是写代码，是记住哪些行为是“各家都一样”，哪些是“看起来像但其实差很远”。比如 PutObject 都有 key 和 body 参数，但 OSS 对 key 长度限制 1023 字节，S3 是 1024，GCP 是 2048；再比如 MinIO 默认开启 checksum 校验，而某些私有 COS 实例可能关着——这些细节一旦漏掉，上线后就是静默数据损坏。
