Buffalo框架不支持per-route上传大小限制，必须用自定义中间件校验ContentLength，因app.Options.MaxBodySize是全局限制且无法区分路由；中间件需针对POST/PUT请求检查Content-Length，超限返回413，并处理分块传输场景。
Buffalo 框架本身不提供 per-route 的上传大小限制，必须通过中间件手动控制，且不能依赖 app.Options.MaxBodySize（它是全局生效的）。真正可行的方式是：在目标路由前插入自定义中间件，读取并校验 c.Request().ContentLength，超限时提前返回 413 Payload Too Large。
为什么不能直接用 app.Options.MaxBodySize
app.Options.MaxBodySize 是 Buffalo 启动时设置的全局限制，作用于所有请求（包括静态文件），无法按路由区分。一旦设为 5MB，/api/upload 和 /public/logo.png 都受同一限制——这在实际项目中几乎不可接受。
如何为单个 POST 路由加上传大小校验
你需要一个轻量中间件，在 handler 执行前检查 Content-Length 头或尝试读取部分 body。推荐用前者，避免消耗流：
- 只对
POST或PUT请求生效，跳过GET/HEAD - 检查
c.Request().ContentLength是否 > 期望阈值（如 10MB = 10_485_760） - 若超限，调
c.Error(413, errors.New("payload too large"))并 return，阻止后续执行 - 注意：该值可能为 -1（分块传输），此时需用
io.LimitReader+io.Discard安全跳过
示例中间件：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
func MaxUploadSize(limit int64) buffalo.MiddlewareFunc {
return func(next buffalo.Handler) buffalo.Handler {
return func(c buffalo.Context) error {
if c.Request().Method != "POST" && c.Request().Method != "PUT" {
return next(c)
}
if cl := c.Request().ContentLength; cl > limit && cl != -1 {
return c.Error(413, fmt.Errorf("payload too large: %d > %d", cl, limit))
}
if cl == -1 {
// chunked encoding: drain first N+1 bytes to detect overflow
n, _ := io.CopyN(io.Discard, c.Request().Body, limit+1)
if n > limit {
return c.Error(413, fmt.Errorf("payload too large (chunked)"))
}
c.Request().Body = io.NopCloser(io.MultiReader(
bytes.NewReader(make([]byte, n)),
c.Request().Body,
))
}
return next(c)
}
}
}
注册方式：app.POST("/upload", UploadHandler).Use(MaxUploadSize(10_485_760))
常见坑：body 已被读、multipart 解析失败、前端没传 Content-Length
真实场景中容易踩这几个点：
- 如果上游已有中间件（比如
middleware.ParameterParser）提前读了 body，c.Request().ContentLength可能仍是 -1，且Body已为空——此时校验失效 - 浏览器表单提交 multipart 时，
Content-Length是准确的；但 fetch + FormData 在某些旧版 Chrome 下可能不带该 header - 不要在中间件里调
r.ParseMultipartForm，它会一次性把整个文件读进内存，失去“限制”意义 - 若需解析 multipart 并限制单个文件大小，必须用
maxMemory参数传给ParseMultipartForm，而不是靠中间件
最稳妥的做法是：全局设一个偏大的 app.Options.MaxBodySize（比如 100MB），再用中间件做 per-route 精细拦截——因为后者可写逻辑、打日志、返回定制错误页，而前者只能硬 413。
