Buffalo中间件必须严格使用func(next buffalo.Handler) buffalo.Handler签名，显式调用c.Next()（同步阻塞），前置逻辑在c.Next()前、后置逻辑在其后，漏调或异步调用均导致请求卡死或panic。
中间件函数必须严格匹配 buffalo.MiddlewareFunc 签名
Buffalo 不接受标准库风格的中间件，比如 func(http.Handler) http.Handler 或 func(w http.ResponseWriter, r *http.Request)。它只认一种签名：func(next buffalo.Handler) buffalo.Handler，且内部必须显式调用 c.Next() 才能继续执行链路。
漏掉 c.Next()，请求就卡死；写成 go c.Next()，会因并发导致 context 丢失或 panic；返回值类型不是 buffalo.Handler，app.Use() 直接编译失败或运行时 panic。
- 正确结构里，
c.Next()是同步阻塞调用，等下游全部执行完才返回，可用于统计耗时、捕获错误 - 前置逻辑（如打印路径）放
c.Next()前，后置逻辑（如记录状态码）放之后 - 不要在中间件里调
c.Render()或c.Error()，除非你明确要中断流程并返回响应
app.Use()、Group.Use() 和路由级 .Use() 的作用范围差异
注册位置决定中间件是否生效、对谁生效——不是“加了就全局起效”。错一层，API 鉴权可能绕过，日志可能漏记静态资源，panic 捕获器可能根本没机会运行。
-
app.Use(MyMiddleware)：全局生效，包括/public/下的静态文件（除非你手动禁用了middleware.Static） -
app.Group("/api", func(g *buffalo.RouterGroup) { g.Use(MyMiddleware) })：仅限该前缀下所有路由，适合做 API 版本校验或统一鉴权 -
app.GET("/health", HealthHandler).Use(MyMiddleware)：只对该单一路由生效，极少用于生产，调试时临时加日志可用
常见坑：把日志中间件放在 pop.Transaction(app.DB) 后面，结果你在中间件里读不到 c.Value("tx") —— 因为事务中间件还没执行，context 里压根没塞进去。
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
读取 Body、修改 Header 和透传 Context 的实操要点
Buffalo 的 c.Request().Body 和标准库一样是单次可读流。中间件里一读就空，后续 handler 再读就是 EOF；Header 修改直接 Set() 即可；Context 里想透传数据，得手动塞进 c.Data() 或用 c.Set()，不能依赖隐式传递。
- 要读 Body（比如做签名验证），先缓存：
bodyBytes, _ := io.ReadAll(c.Request().Body); c.Request().Body = io.NopCloser(bytes.NewBuffer(bodyBytes)) - 大文件别这么干——生产环境应限制 JSON body 大小，靠
middleware.ParameterParser的MaxMemory控制 - Header 修改直接
c.Response().Header().Set("X-Request-ID", reqID)，无需额外 wrap - 想让下游 handler 拿到自定义字段，必须显式调
c.Set("user_id", 123)，否则c.Data()里没有
为什么有些中间件看似注册了却没执行
最常被忽略的是顺序和拦截逻辑：一个中间件提前 return 或 c.Error()，后面所有中间件就彻底跳过；静态资源被 middleware.Static 拦截，日志中间件若注册太晚，就根本收不到请求；CORS 或认证中间件若位置靠后，版本校验可能被绕过。
- API 版本校验中间件必须放在最前面，否则
/api/v1/users可能被日志或 auth 中间件先处理，再进版本检查就晚了 - 用
strings.HasPrefix(path, "/api/v1/")判断，别用正则——快、安全、无回溯风险 - 静态资源请求（如
/assets/app.js）默认走middleware.Static，它不经过其他中间件，除非你手动关掉它 - 如果用了
gzip.Middleware，自定义日志中间件必须放在它之后，否则读不到真实响应体大小
真正容易被忽略的点是：中间件注册顺序不是“写代码的顺序”，而是 app.Use() 调用的先后；而 app.AutomaticResourceRouting() 会插入一堆内置中间件，它之后再 Use() 就很可能被覆盖或跳过。
