Buffalo 的路由注册逻辑全部写入 app.go,执行 buffalo generate resource 后会追加 app.Resource("/users", UsersResource{}),对应结构体在 actions/users.go;HTTP 方法映射由框架内部约定完成,可通过 buffalo routes 命令查看是否成功注册。

Buffalo 的路由命令本身不会出错,但你看到“路由没生效”“资源访问 404”,90% 是 dev 环境没刷新、handler 类型不匹配、或注册顺序错了。
buffalo generate resource 生成的路由在哪看
它不生成独立路由文件,所有注册逻辑都落在 app.go 里——执行完命令后,你会看到类似 app.Resource("/users", UsersResource{}) 这一行被追加到 app.New() 函数内部。对应的 UsersResource{} 结构体定义在 actions/users.go,它实现了 List、Show 等方法,而 HTTP 方法映射(比如 GET /users → List)由 buffalo.Resource 内部约定完成,不是靠显式写 app.GET。
想确认是否注册成功?直接运行 buffalo routes,它会列出所有已注册的路由及其 handler 函数名。如果没出现,说明 app.go 没保存,或命令没在项目根目录执行。
手动加路由时 app.GET 不生效的三个硬性条件
必须同时满足以下三点,app.GET 才真正挂载成功:
Buffalo框架 1.0.1 版本源码包下载,适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
-
app.GET("/path", MyHandler)调用必须放在app.Use(...)中间件注册之后、app.ServeFiles(...)之前;否则会被中间件拦截,或被静态文件路由兜底返回 404 -
MyHandler必须是func(c buffalo.Context) error类型;写成func() error或漏掉参数都会编译失败或 panic - handler 函数名不能带括号:
app.GET("/test", Home)✅,app.GET("/test", Home())❌(后者是立即调用,传的是返回值,不是函数引用)
路由参数取不到?检查 c.Param 和路径写法
像 app.GET("/users/{id}", UserShow) 这种带路径参数的写法,取值只能用 c.Param("id"),不是 c.Request().URL.Query().Get("id")(那是 query string)。常见错误包括:
- 路径写成
/users/:id或/users/:id/—— Buffalo 只认{id},冒号前缀或尾部斜杠会导致匹配失败 - 在 handler 里误用
c.Param("ID")(大小写敏感),实际注册的是{id} - 参数名含下划线如
{user_id},取值时也必须写c.Param("user_id"),不能简写为c.Param("id")
改了 app.go 但页面还是老样子
Buffalo 的 buffalo dev 模式确实支持热重载,但它只监听 actions/、templates/、public/ 等目录下的变更。修改 app.go 属于应用初始化层改动,buffalo dev 不会自动重启进程——你必须手动 Ctrl+C 停掉,再重新运行 buffalo dev。这是最容易忽略的一点,也是绝大多数“路由不生效”问题的根源。










