obsclient是线程安全的obs客户端，应单例初始化并全局复用；需从环境变量读取ak/sk，endpoint须带协议且不以/结尾，严格匹配桶所在region。
直接用 ObsClient 就行，Gin 本身不参与 OBS 协议交互，只负责接收文件、转给 SDK、返回结果。关键在初始化 client 和处理 MultipartFile（实际是 *multipart.FileHeader）的转换。
怎么初始化 ObsClient 并复用
不要每次上传都 new 一个 ObsClient，它内部维护连接池和线程安全，应该单例初始化并注入到 Gin 的上下文或全局变量里。
-
ObsClient是线程安全的，适合长期持有 - endpoint 必须带协议（
https://或http://），且不能以/结尾；常见错误是拼成https://bucket.obs.cn-north-4.myhuaweicloud.com/（多了一个斜杠） - AK/SK 建议从环境变量或配置中心读取，避免硬编码；尤其别写死在 handler 里
- 如果使用华为云 Stack（私有云），endpoint 格式通常是
https://obs.<region>.xxx.com</region>，不是公有云的myhuaweicloud.com域名
Gin 接收文件后怎么传给 ObsClient
Gin 的 c.FormFile("file") 返回的是 *multipart.FileHeader，不能直接塞给 putObject——后者要 File 或 InputStream。得先保存临时文件，或用 Open() 拿到 io.ReadSeeker。
- 小文件（header.Open() 得到
io.ReadSeeker，传给PutObjectRequest的inputStream字段，设objectSize（否则 SDK 可能 fallback 到分段上传） - 大文件（>100MB）：必须走分段上传（
initiateMultipartUpload+ 多个uploadPart+completeMultipartUpload），不然内存爆或超时 - 别用
c.SaveUploadedFile()再读——多一次磁盘 IO，纯属冗余 -
objectKey建议加前缀（如uploads/2026/09/），避免根目录杂乱；注意长度总和 ≤ 1023 字节
常见 403 / 400 错误怎么快速定位
上传失败时，ObsClient 抛出的 ObsException 里含真实错误码（如 InvalidAccessKeyId、SignatureDoesNotMatch），不是 HTTP 状态码本身。
- 403 +
InvalidAccessKeyId：AK 不对，或对应 SK 已被禁用/删除 - 403 +
SignatureDoesNotMatch：时间偏移太大（服务器校验请求头里的Date，误差超过 15 分钟就拒），或 endpoint、bucketName 大小写/拼写错（OBS bucket 名全局唯一且严格区分大小写） - 400 +
InvalidObjectName：objectKey含非法字符（如\、控制字符）或超长 - 400 +
MissingContentLength：没设contentLength且流不可 seek（比如用bytes.NewReader但没 rewind）
要不要自己实现预签名 URL 上传
如果前端直传（绕过你的 Gin 后端），才需要生成预签名 URL；否则纯后端上传，没必要。Gin 这层只管“把文件送进 OBS”，不暴露 AK/SK 给前端。
- 预签名 URL 本质是后端调用
ObsClient.generatePresignedUrl，返回一个带签名的PUT地址，前端用 axios 直传 - 此时后端无需处理文件流，但要校验
contentType、size等策略条件（通过Policy构造） - 直传省了后端带宽和内存，但调试更麻烦（比如 Host 头冲突、CORS 配置漏项）
- 绝大多数内部系统用后端代理上传更稳，也方便统一鉴权、日志、限速
最易忽略的一点：华为云 OBS 的 endpoint 和桶所在 region 必须严格匹配，比如桶建在 cn-east-3，就不能用 cn-north-4 的 endpoint，哪怕你 AK/SK 正确也会报 403 —— 错误信息里不会明说 region 不对，得自己核对控制台桶详情页的“区域”字段。
