buffalo routes是唯一可靠方式,实时列出运行时路由树中所有已注册路由及绑定中间件,但需确保在正确目录执行、app.go存在且app.Routes()已调用,否则输出为空或过期。

buffalo routes 是唯一可靠的方式,能实时列出当前项目中所有已注册的路由(含中间件标记),它不依赖缓存或配置文件解析,而是直接读取运行时路由树。
执行 buffalo routes 前必须满足的条件
该命令本身不要求在项目根目录运行,也不检查 go.mod 是否存在——但它列出的路由,仅反映当前目录下 app.go 中实际构建出的 buffalo.App 实例所注册的内容。所以:
- 如果你在错误目录执行(比如父级或子目录),
buffalo routes仍会跑,但可能加载不到正确的app.go,导致输出为空或过期路由 - 如果项目尚未生成(即没跑过
buffalo new),或app.go被手动删改、未调用app.Resource/app.GET等注册函数,输出就是空的 - 它不会显示被中间件拦截后“逻辑上不可达”的路由,只显示注册表里的原始条目
buffalo routes 输出字段含义和常见误读
典型输出类似:
GET /posts PostsResource.List
POST /posts PostsResource.Create
GET /posts/{id} PostsResource.Show middleware.A, middleware.B
注意三点:
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
-
{id}是路径参数占位符,不是字面量;若看到/posts/:id,说明你用的是旧版 Buffalo(v0.16.x 之前),升级后统一为花括号语法 - 末尾的
middleware.A, middleware.B表示该路由绑定了哪些中间件——但不体现执行顺序,只列名称;要确认顺序得查app.Use()或group.Use()的调用链 - 如果某路由在代码里写了
app.GET("/api/users", UsersHandler),但输出里没有,大概率是app.Routes()函数没被调用,或被if GO_ENV == "test"这类条件包裹跳过了
为什么 buffalo routes 找不到刚加的嵌套路由?
嵌套路由靠 app.Scope("/posts/{post_id}", ...) 注册,它本质是创建一个子路由组。这类路由在 buffalo routes 输出中会扁平化显示,例如:
GET /posts/{post_id}/comments CommentsResource.List
但前提是:
-
app.Scope(...)必须写在app.Routes()函数体内,且在app.Resource("/posts", ...)之后 - 不能写成
app.Scope("/posts/{post_id}").Resource("/comments", ...)——Scope返回的是*buffalo.RouterGroup,不支持链式调用Resource - 如果用了
app.Group("/v1", ...)包裹整个 API,那嵌套路由前缀会变成/v1/posts/{post_id}/comments,别漏看前缀
真正容易被忽略的是:路由注册发生在 app.Routes() 调用时,而这个函数通常只在 app.go 初始化阶段执行一次。改了 routes.go 后不重启 buffalo dev,buffalo routes 就不会更新——它读的是内存中的当前实例,不是源码文件。


















