Buffalo 是 Go Web 框架，对接阿里云 OSS 需使用官方 Go SDK，在 app.go 初始化带超时与重试的 oss.Client，封装为 service 层，Endpoint 必须含 https 协议，密钥从环境变量读取，并绕过默认 multipart 限制。
确认用的是 Go 版 Buffalo，不是 PHP 或 Java 框架
很多开发者搜 “Buffalo OSS” 时实际在用 PHP 或 Java 项目，结果套错 SDK。Buffalo 是 gobuffalo/buffalo，基于 Go 构建，必须用 github.com/aliyun/aliyun-oss-go-sdk/oss（官方 Go SDK），不能用 PHP 的 aliyuncs/oss-sdk-php 或 Java 的 aliyun-sdk-oss。运行 go list -m all | grep oss 确认引入的是 Go SDK。
初始化 oss.Client 要避免全局单例滥用
常见错误是把 oss.Client 声明为包级变量并复用，但其内部连接池和超时设置对并发上传/下载敏感。正确做法是：
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 在 Buffalo 的
app.go初始化阶段创建 client，并传入自定义oss.Timeout和oss.RetryTimes - 不直接暴露 client 给 handler，而是封装成 service 层（如
oss.UploadService） - Endpoint 必须带协议，例如
https://oss-cn-hangzhou.aliyuncs.com；填oss-cn-hangzhou或http://...会报InvalidEndpoint或 TLS 握手失败 - AccessKeySecret 绝对不能硬编码在
app.go，应从环境变量读取：os.Getenv("OSS_ACCESS_KEY_SECRET")
文件上传逻辑要绕过 Buffalo 默认的 multipart 解析限制
Buffalo 默认用 net/http.Request.ParseMultipartForm，但大文件上传易触发 http: request body too large 错误。OSS 推荐服务端签名直传（前端直传），但若必须后端中转：
- 在
app.Use(func(c buffalo.Context) error { ... })中提前调用c.Request().ParseMultipartForm(32 （设为 32MB） - 上传到 OSS 时改用
PutObject+io.Reader流式写入，别先c.File()保存临时文件 —— 否则多一次磁盘 IO，还占内存 - 示例关键行：
err := bucket.PutObject(objectKey, c.Request().MultipartForm.File["file"][0].Open())
签名直传需后端生成 policy + signature，不能交由前端计算
前端 JS 计算 Signature 会暴露 AccessKeySecret，这是高危操作。Buffalo 应负责生成含时效的临时凭证：
- policy 内容必须是 JSON 字符串，且
expiration用 ISO8601 格式（如"2026-09-20T14:00:00Z"） - signature 计算三步不可省：
base64.StdEncoding.EncodeToString([]byte(policy))→hmac.New(...).Sum(nil)→base64.StdEncoding.EncodeToString(...) - 返回给前端的字段至少包含：
host（https://<bucket>.oss-cn-hangzhou.aliyuncs.com）、policy、signature、OSSAccessKeyId、key（建议带时间前缀，如uploads/<unix>/<name>）
PutObject 默认不校验 Content-MD5，若业务要求强一致性，必须显式传入 oss.ContentMD5 参数，否则网络中断重试时可能写入损坏文件。另外，Bucket 的 CORS 配置若没放开 POST 和 PUT 方法，前端直传会卡在预检请求（OPTIONS）失败，错误信息是 No 'Access-Control-Allow-Origin' header —— 这个得去 OSS 控制台配，Buffalo 代码里解决不了。 
