buffalo.App.ServeHTTP 是实际请求入口,实现 http.Handler 接口,调用 app.router.ServeHTTP 进行路径匹配并注入参数到 c.Params(),routes.go 仅声明路由不参与匹配。

buffalo.App.ServeHTTP 是实际入口,不是 routes.go 注册逻辑
你打开 routes.go 看到的 app.GET、app.Resource 都只是构建路由树的声明式调用,真正分发请求的是 buffalo.App.ServeHTTP 方法——它实现了 Go 标准库的 http.Handler 接口,所有 HTTP 请求最终都落到这个函数上。别在 routes.go 里找“匹配逻辑”,它只负责把路由规则塞进 app.Routes 这个内部结构体。
关键点:
-
app.ServeHTTP内部调用app.router.ServeHTTP,而app.router是一个封装了github.com/gorilla/mux的实例(v1.x 后改用自研buffalo/router,但行为兼容) - 路径匹配发生在
router.ServeHTTP阶段,匹配结果存入c.Request().URL.Path和c.Params(),后续 handler 才能读到c.Param("id") -
routes.go中的app.Scope或app.Group实际是往路由树插入子节点,不改变匹配算法本身
Param() 和 Params() 的来源:URL 解析后写入 context,非运行时反射
c.Param("id") 看起来像从 struct tag 取值,其实完全不是——它直接从 c.Params() 这个 map[string]string 里取,而该 map 是 router 在匹配成功后,把命名路径参数(如 /users/{id})的值解析出来并注入的。没有中间层缓存或 lazy 初始化,就是一次 map 查找。
常见误解和坑:
- 写
app.GET("/users/:id", Handler)→c.Param("id")为空:因为 Buffalo 要求命名参数必须用大括号,即{id},冒号语法是 gorilla/mux 的旧写法,Buffalo v1+ 已弃用 - 嵌套路由中
c.Param("post_id")可用,但c.Param("id")不会自动降级查找:每个 scope 独立解析,父 scope 的参数不会透传到子 handler - 如果路径是
/api/v1/users/{id}/profile,c.Param("id")有效,但c.Param("version")无效——除非你显式写成/api/{version}/users/{id}
中间件链执行顺序 = 注册顺序 × 路由匹配优先级
中间件不是“注册完就生效”,它的执行时机由两层决定:一是 app.Use() 的调用顺序,二是路由是否匹配。比如你注册了:
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
app.Use(mwA)
app.Use(mwB)
app.GET("/health", HealthHandler)
app.GET("/api/{id}", APIHandler)
那么对 /health 请求,执行流是:mwA → mwB → HealthHandler;对 /api/123 也是同样顺序。但如果在 app.GET 之后又加了 app.Use(mwC),它对这两个路由都不生效——app.Use() 只影响它之后注册的路由。
容易被忽略的细节:
-
app.Use()注册的中间件对/public/*和静态文件也生效,除非你手动禁用Static中间件 -
app.Resource("/posts", PostsResource{})本质是批量注册 7 个app.GET/app.POST等,所以它前面的app.Use()会作用于全部子路由 - 中间件里调用
c.Next()是同步阻塞的,下游 panic 会原样向上抛,不会被上层中间件捕获——除非你在c.Next()外包一层defer/recover
路由匹配失败时返回 404,但不走任何中间件
当请求路径没被任何 app.GET、app.POST 或 app.Resource 匹配时,Buffalo 会直接返回 404,且跳过所有已注册的中间件(包括 Logger 和 RequestID)。这意味着你日志里看不到这条 404 记录,监控也抓不到——它根本没进中间件链。
要捕获这类请求,唯一办法是注册兜底路由:
app.NotFound(func(c buffalo.Context) error {
c.Response().WriteHeader(404)
return c.Render(404, r.String("not found"))
})
注意:app.NotFound 是最后防线,它不参与正常中间件链,所以里面不能依赖 c.Session() 或 c.Flash()(它们还没初始化)。真要统一处理 404,得在 app.Use() 里做 recover + 路径检查,成本高、易出错。


















