必须手动调用 r.ParseMultipartForm(32

Buffalo 框架不会自动解析 multipart/form-data 请求体,r.MultipartForm.File 默认为空——这是你上传后拿不到文件的最常见原因。必须手动调用 r.ParseMultipartForm,且要提前设置内存上限,否则大文件会直写磁盘、路径不可控、甚至触发 panic。
必须显式调用 ParseMultipartForm 才能拿到文件
Buffalo 不像 Gin 或 Echo 那样在中间件里自动解析表单。如果你跳过这步,r.MultipartForm 就是 nil,r.MultipartForm.File["file"] 会 panic 或返回空 slice。
- 在 handler 开头立即调用
r.ParseMultipartForm(32 (32MB 内存缓冲) - 传参必须是
int64,别用32 * 1024 * 1024这种易溢出写法 - 如果只处理小图,设成
8 (8MB)更安全,避免 OOM - 错误时直接
c.Error(400, err),别忽略返回值
保存文件前务必校验 FileHeader 和内容类型
*multipart.FileHeader 只是元信息,不代表文件真实存在或合法。攻击者可伪造 Filename 或 Header["Content-Type"],直接保存会引发路径遍历或执行风险。
Buffalo框架 1.0.1 版本源码包下载,适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 用
header.Filename前先过path.Base(),丢弃所有../和控制字符 - 用
header.Header.Get("Content-Type")判断是否为image/jpeg等可信类型,但不能全信——需用http.DetectContentType读前 512 字节再校验 magic bytes - 生成保存路径时,用
filepath.Join(uploadDir, uuid.NewString()+".jpg"),永远不用原始文件名 - 调用
header.Open()后记得defer f.Close(),否则句柄泄漏
缩略图生成必须脱离 Buffalo 的 HTTP 生命周期
Buffalo 默认不集成图像处理能力,也不推荐在 handler 里做耗时缩略图操作——它会阻塞 goroutine、拖慢整个路由响应,且失败时无法回滚已保存的原图。
- 把原图先保存到临时目录(如
/tmp/uploads/),返回成功状态码给前端 - 用独立 goroutine 或消息队列(如 buffalo-worker + Redis)异步处理缩略图
- 缩略图库推荐
github.com/disintegration/imaging:轻量、无 CGO、支持 JPEG/PNG/WebP - 别用
golang.org/x/image的jpeg.Decode直接读大图,容易 OOM;先用imaging.Resize流式缩放
最容易被忽略的是:Buffalo 的 buffalo-pop ORM 不处理文件字段,FileHeader 必须由你手动落地为磁盘路径或对象存储 URL,再存进数据库。这个“手动”不是可选项,而是框架设计决定的边界——它把文件生命周期完全交还给你。

















