Buffalo 默认不支持 COS，因其上传方法依赖标准库 multipart.Form 和临时文件系统，未提供云存储抽象层或 Storage 接口，所有上传默认写入本地磁盘，即使配置 COS 凭据也无效。
Buffalo 框架本身不内置 COS 支持，必须通过自定义 io.Writer 或封装 cosgo SDK 实现上传逻辑，否则文件会默认写入本地磁盘或内存。
为什么 Buffalo 默认不支持 COS
Buffalo 的 buffalo.Context 中的 c.File()、c.Upload() 等方法底层依赖 Go 标准库的 multipart.Form 和临时文件系统，没有抽象出云存储适配层。它不像 Django 或 Laravel 那样有统一的 Storage 接口。直接调用上传 API 不会自动转发到 COS。
- 所有上传行为默认走
os.TempDir()，哪怕你配置了 COS 凭据也完全无效 - 没有
Storage类型或中间件自动拦截Upload请求 - 若强行在 handler 里用
cosgo.Client.PutObject，需手动解析 multipart、读取*multipart.FileHeader，并处理流式上传边界
用 cosgo SDK 手动上传文件到 COS
推荐使用腾讯云官方 Go SDK：github.com/tencentyun/cos-go-sdk-v5（注意不是旧版 cos-go）。关键点在于：别把整个文件 load 进内存，要用 io.Reader 流式上传。
- 先从
c.Request().MultipartForm获取*multipart.FileHeader，再用header.Open()得到io.ReadCloser - 构造
cos.ObjectPutOptions时显式设置ContentType，否则 COS 可能识别为binary/octet-stream，导致浏览器无法 inline 展示图片 - Bucket 名称必须带地域后缀，例如
my-bucket-1251234567.cos.ap-shanghai.myqcloud.com，不能只填my-bucket - Region 必须与创建 Bucket 时一致，比如
cos.AP_SHANGHAI，错填会导致403 Forbidden或404 NoSuchBucket
简短示例：
腾讯云通用文字识别（高精度版）技能包。用户发送/粘贴图片、提供图片URL或要求识别图片文字时自动调用。支持中文、英文、中英混合、数字及特殊符号的检测与识别，返回文字框位置与内容。适用于文字较多、版式复杂、准召率要求高的场景。
func UploadToCOS(c buffalo.Context) error {
form, err := c.Request().MultipartForm
if err != nil {
return err
}
for _, fh := range form.File["file"] {
f, err := fh.Open()
if err != nil {
return err
}
defer f.Close()
client := cos.NewClient(&cos.BaseURL{BucketURL: "https://my-bucket-1251234567.cos.ap-shanghai.myqcloud.com"}, &http.Client{})
_, err = client.Object.Put(c.Context(), fh.Filename, f, &cos.ObjectPutOptions{
ObjectPutHeaderOptions: &cos.ObjectPutHeaderOptions{
ContentType: fh.Header.Get("Content-Type"),
},
})
if err != nil {
return err
}
}
return c.Render(200, r.JSON(map[string]string{"status": "ok"}))
}
COS 配置容易被忽略的三个硬性条件
即使代码逻辑正确，以下任一条件不满足都会导致上传静默失败或返回奇怪错误（如 400 Bad Request、401 Unauthorized）：
-
secretID和secretKey必须来自「访问管理 → API 密钥管理」，不能是控制台登录密码或临时 token - 所用账号需对目标 Bucket 具备
cos:PutObject权限；若用子用户，需在 CAM 控制台为其附加QcloudCOSFullAccess或最小化策略 - Bucket 的「跨域访问（CORS）」必须显式允许当前前端域名，否则浏览器端直传会触发
Blocked by CORS policy—— 这和 Buffalo 后端无关，但常被误判为后端问题
要不要用 cloud-upload-hub 做中转
不推荐。虽然 cloud-upload-hub 支持 COS，但它定位是 CLI/前端工具，没有提供 Go 包或 HTTP 服务接口，无法嵌入 Buffalo handler。强行起子进程调用 CLI 会带来权限、路径、超时、错误捕获等额外复杂度，远不如直接用 cosgo SDK 稳定。
真正需要简化的是上传流程抽象 —— 建议自己封装一个 COSUploader 结构体，把 client 初始化、region 映射、错误码翻译、重试逻辑收拢起来，而不是引入外部工具链。
