用aws-sdk-go-v2通过自定义endpointresolver和credentialsprovider统一接入s3兼容存储，避免多sdk依赖冲突、接口割裂与测试成本高；filestore接口应极简抽象upload/download/delete，屏蔽sdk细节，关键字段如contenttype应在实例化时配置而非调用时传入。
直接用 aws-sdk-go-v2 + 自定义 EndpointResolver 和 CredentialsProvider，就能在不引入多个 SDK 的前提下，统一调用阿里云 OSS、腾讯云 COS、华为云 OBS 甚至 MinIO——关键不是写一堆 if-else 判断厂商，而是让 S3 协议成为事实标准。
为什么不用各云原生 SDK？
硬集成 aliyun/oss、tencentcloud/cos、huaweicloud/obs 会带来三类实际问题：
- 依赖冲突：各 SDK 对
github.com/aws/smithy-go或golang.org/x/net版本要求不一，go mod tidy经常报错 - 接口割裂：上传方法名分别是
PutObject、PutObject（但参数结构完全不同）、PutObject（又带额外 header 控制），业务层必须重复适配 - 测试成本高：本地想 mock 阿里云响应，得起真实 endpoint 或写复杂 stub，而 S3 兼容服务（如 MinIO）可直接复用
如何用 aws-sdk-go-v2 接入所有 S3 兼容存储
核心是替换两个配置项，其余代码完全复用 s3.PutObject、s3.GetObject 等标准调用：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
-
config.WithEndpointResolverWithOptions：把https://s3.us-east-1.amazonaws.com换成对应云的 endpoint，例如阿里云杭州区域是https://oss-cn-hangzhou.aliyuncs.com -
config.WithCredentialsProvider：传入各云的AccessKeyID和SecretAccessKey，无需改写签名逻辑——S3 v4 签名协议已被广泛兼容 - 注意 region 参数：即使不走 AWS，也要填一个“逻辑 region”，比如阿里云填
cn-hangzhou，否则某些 SDK 版本会 panic - MinIO 需显式关闭 SSL 验证（仅开发环境）：
config.WithHTTPClient(&http.Client{Transport: &http.Transport{TLSClientConfig: &tls.Config{InsecureSkipVerify: true}}})
FileStore 接口怎么设计才真正解耦
不能把 s3.PutObjectInput 这类 SDK 类型暴露给业务，否则换存储时仍要改调用方。正确做法是定义极简接口：
-
Upload(ctx context.Context, key string, reader io.Reader, size int64) error：size 必须传，避免流式上传时 SDK 内部反复 seek -
Download(ctx context.Context, key string) (io.ReadCloser, error)：返回io.ReadCloser而非字节切片，防止大文件 OOM -
Delete(ctx context.Context, key string) error：不支持批量删就别加 batch 参数，后续扩展用新方法 - 所有方法不接收
*s3.S3客户端或minio.Client，只依赖接口本身——实现体内部才初始化具体 client
本地文件系统适配最容易翻车的点
当你要把 FileStore 同时支持磁盘和云存储时，os 操作的路径处理稍有不慎就会线上被利用：
- 输入
key必须过filepath.Clean()，再检查是否以".."开头，否则../../etc/passwd直接逃逸 - 写入前用
os.Stat(dir)检查父目录，不存在就os.MkdirAll(dir, 0755)，别信“部署时已建好目录”这种假设 - Linux 下创建文件必须显式设权限：
os.O_CREATE | os.O_WRONLY | 0644，否则受 umask 影响可能生成0600导致 web server 读不到 - 不要用
ioutil.ReadFile加载大文件，用os.Open+io.Copy流式处理，否则内存暴涨
真正难的不是对接几个云，而是让业务代码从第一天起就只认 store.Upload("logs/20260803.txt", r) 这一行——后续无论底层换成 S3、OSS 还是 NFS，都不动这一行。这要求你在定义接口时砍掉所有“看起来有用但实际绑定实现”的字段，比如 ContentType、ACL、StorageClass。它们该出现在构造 FileStore 实例时的配置里，而不是每次上传都传一遍。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
