buffalo中间件默认全局生效，无法直接跳过某路由；实际需通过中间件内路径判断提前return，或使用app.group()创建分组路由并局部注册中间件来实现逻辑隔离。
Buffalo 中间件默认是全局生效的，无法直接“跳过”某个路由
Buffalo 的 app.Use() 注册的中间件会作用于所有路由，它没有内置的 skipIf() 或路由级中间件开关机制。你不能像 Gin 那样在某个 GET("/admin", handler) 上单独禁用某个中间件。所谓“跳过”，实际是靠**中间件内部判断路径并提前 return**，或**改用局部中间件注册方式**。
用中间件内部路径判断实现逻辑跳过
这是最常用、也最可控的方式：把需要条件跳过的逻辑写进中间件函数体里，用 c.Request().URL.Path 或 c.Request().Method 做判断。比如你想让 csrf.New() 不作用于 /api/v1/webhook：
func SkipCSRFForWebhook(next buffalo.Handler) buffalo.Handler {
return func(c buffalo.Context) error {
path := c.Request().URL.Path
if path == "/api/v1/webhook" && c.Request().Method == "POST" {
return next(c)
}
// 其他路径才执行原始 CSRF 中间件
return csrf.New()(next)(c)
}
}
// 在 app.go 中替换原来的 app.Use(csrf.New())
app.Use(SkipCSRFForWebhook)
- 注意顺序：这个包装中间件必须放在
csrf.New()原始调用的位置，否则不会生效 - 别漏掉
next(c)调用，否则请求就卡住了 - 路径匹配建议用
strings.HasPrefix(path, "/api/")而非完全相等，避免漏掉带查询参数的请求
用分组路由 + 局部中间件替代全局注册
Buffalo 支持 app.Group() 创建子路由组，并为该组单独挂载中间件。这是更干净的解耦方式，尤其适合 API 与管理后台分离的场景：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
// 公共中间件（日志、panic 捕获等）
app.Use(middleware.Logger)
app.Use(middleware.Recover)
// Web UI 路由（带 session、CSRF、模板渲染）
web := app.Group("/")
web.Use(session.Sessions("key"))
web.Use(csrf.New())
web.GET("/", HomeHandler)
// API 路由（跳过 session/CSRF，只用 auth 和 JSON 处理）
api := app.Group("/api")
api.Use(auth.TokenAuth()) // 自定义鉴权
api.Use(middleware.JSONRequest) // 强制解析 JSON body
api.POST("/users", UserCreateHandler)
-
app.Group()返回的是新路由实例，Use()只影响该组内注册的 handler - 全局
app.Use()仍会对所有路由生效，所以要把真正“全局”的中间件（如日志）放最前面，再分组 - 这种结构天然隔离了中间件作用域，比在中间件里写 if 判断更易维护
为什么不能用中间件链顺序“覆盖”来跳过？
有人尝试先注册一个“空中间件”或“return nil”的中间件想覆盖前一个，这行不通。Buffalo 的中间件链是线性执行的，每个中间件都必须显式调用 next(c) 才能往下走；你不调用，后续中间件（包括目标 handler）根本不会执行——这不是跳过，是中断。
另外，middleware.Automatic 这类 Buffalo 内置中间件（如自动设置 content-type、处理 OPTIONS）是硬编码进框架启动流程的，无法通过 app.Use() 控制其作用范围，只能整体关闭或接受默认行为。
真正要跳过某类中间件，要么重构为分组路由，要么在中间件内部做路径判断——没有第三条路。最容易被忽略的是：分组路由的 Use() 不会继承父组中间件，但全局 app.Use() 依然穿透，这点在调试时经常导致预期外的行为。
