Buffalo框架的路由拦截器本质是中间件，需用app.Use()绑定符合func(c buffalo.Context) error签名的函数；UseHandler()仅用于标准http.Handler，混用将导致上下文丢失。
Buffalo 框架的路由拦截器本质是中间件（middleware），不是独立的“拦截器类型”，直接用 app.Use() 或 app.Group().Use() 绑定函数即可，不存在额外注册或注解声明。
中间件函数必须返回 error
Buffalo 的中间件签名强制要求返回 error，否则编译失败或 panic。常见错误是写成无返回值函数，或只返回 nil 但漏掉类型声明。
- ✅ 正确签名：
func(c buffalo.Context) error - ❌ 错误写法：
func(c buffalo.Context)（缺少返回值） - ❌ 隐式返回：
return而非return nil（Go 不允许空 return 用于有返回类型的函数）
Use() 和 UseHandler() 的区别别搞混
app.Use() 接收 Buffalo 中间件函数（buffalo.MiddlewareFunc），而 app.UseHandler() 是为标准 http.Handler 设计的桥接入口 —— 用错会导致上下文丢失、c.Session() 为空、Flash 无法工作。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 需要访问
c.Param()、c.Session()、c.Render()等 Buffalo 特有功能 → 用app.Use() - 只是包装一个纯
http.HandlerFunc（比如日志、CORS 原生 handler）→ 用app.UseHandler() - 第三方 Go 中间件（如
gorilla/handlers）多数需转成http.Handler→ 必须走UseHandler
路由组里绑定中间件要注意作用域
app.Group("/admin") 返回的是新路由组，它的 .Use() 只影响该组内注册的路由，不会污染全局；但 app.Use() 是全局生效的。容易踩坑的是：在 Group 内多次调用 .Use() 却没注意执行顺序。
- 中间件按
Use()调用顺序入栈，先注册的先执行（类似洋葱模型外层） - Group 内
.Use(m1).Use(m2).Get("/x", h)→ 请求时执行顺序是 m1 → m2 → h - 若在 Group 外也调用了
app.Use(m0)，则完整顺序是 m0 → m1 → m2 → h - 想跳过某中间件？只能用
c.Next()显式控制流程，不能靠“不调用 Use”来规避
真正难调试的是中间件里对 c.Response() 的提前写入 —— 一旦 WriteHeader 或 Write 被调用，后续中间件和 handler 就不能再修改状态码或响应体，但 Buffalo 不报错，只会静默失效。这点在做鉴权重定向或 API 统一错误包装时最容易出问题。
