buffalo routes仅显示app.go中显式注册的路由,不自动扫描handlers文件,且受环境变量和中间件影响;输出含METHOD、PATH、NAME、HANDLER四列,不展示中间件链或动态条件路由。

buffalo routes 显示的是当前路由注册表,不是运行时动态路由
Buffalo 没有类似 Rails 的 rake routes 那样自动扫描所有 handler 文件的机制。buffalo routes 命令只输出 app.go 中显式调用 app.GET、app.POST、app.Resource 等注册的路由,且仅限于当前环境(默认是 development)下启用的中间件链所允许的路径。
常见误解是以为它能列出 actions/ 下所有函数——不会。如果你在 actions/users.go 里写了 func ExportHandler,但没在 app.go 里执行 app.GET("/export", actions.ExportHandler),那它就不会出现在 buffalo routes 输出里。
-
buffalo routes输出包含 METHOD、PATH、NAME、HANDLER 四列,其中 HANDLER 是函数全名(如actions.UsersResource.Index),不是文件路径 - 如果用了
app.Resource("/api/users", UsersResource{}),会看到 7 行对应 RESTful 动词,但实际 handler 仍来自UsersResource结构体的方法绑定,不是独立函数 - 带中间件的路由(如加了
app.Use(pop.Transaction))不会额外显示中间件名,但会影响该路由是否能在 dev 模式下被访问(比如 DB 连接失败时整个路由组可能不生效)
为什么 buffalo routes 有时不显示你刚加的路由
最常见原因是:路由注册语句写在了条件分支里,而当前环境未命中。比如:
if env == "production" {
app.GET("/admin/debug", actions.DebugHandler)
}
你在 development 下跑 buffalo routes,这条就不会出现。
- 检查
app.go是否有env := envy.Get("GO_ENV", "development")类似逻辑,并确认当前 shell 的GO_ENV值(可用echo $GO_ENV验证) - 确保
app := buffalo.New(...)之后、return app之前调用了你的路由注册语句;放在return后面的代码根本不会执行 - 如果路由路径含变量(如
app.GET("/users/{id}", ...)),buffalo routes显示的是字面量/users/{id},不是正则或 glob 形式
buffalo routes 不显示中间件和过滤逻辑,但它们真实影响路由行为
buffalo routes 只告诉你“这个路径绑定了哪个函数”,不告诉你“这个函数执行前会经过哪些中间件”。例如:
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 你注册了
app.POST("/upload", actions.UploadHandler),但没关掉csrf.Middleware,那么实际请求会因缺少 token 被拦截,而buffalo routes完全不提示这点 -
app.Resource("/posts", PostsResource{})自动挂载pop.Transaction,意味着每个请求都开启 DB 事务——即使你的Indexhandler 根本不查数据库,开销也已产生 - 自定义中间件(如日志、权限校验)若用
app.Use(myAuth)全局注册,它会作用于所有路由,但buffalo routes输出里没有任何痕迹
要确认中间件是否生效,得看请求日志或在 handler 开头加 c.Log().Info("in handler") 观察是否被调用。
想看完整路由+中间件链,得手动 inspect app.Middleware
Buffalo 的中间件注册是链式累积的,buffalo routes 不展示这部分。真正要看全貌,得进调试模式:
- 在
app.go末尾加一行:fmt.Printf("Middleware stack: %+v\n", app.Middleware),然后buffalo dev启动,终端会打印中间件类型列表(如[session.Middleware csrf.Middleware pop.Transaction]) - 注意:这个列表是全局中间件,对所有路由生效;局部中间件(如
app.Group("/api", func(a *buffalo.App) {...})内注册的)需单独 inspect 对应子路由组的a.Middleware -
app.Middleware是 slice,顺序即执行顺序;靠前的中间件可以提前终止请求(如 CSRF 失败直接返回 403),后面的就永远不会执行
别依赖 buffalo routes 判断“某个请求能不能通”,它只回答“有没有这条路”,不回答“这条路是否畅通”。真实链路得结合中间件配置、环境变量、DB 连接状态一起看。










