Buffalo 的 Handler 必须是 func(c buffalo.Context) error 类型,否则注册失败;需从 c 提取参数、用 c.Render 等输出;函数须导出且显式注册,否则 404;可复用 handler 但禁止包级变量缓存请求数据。

Buffalo 的 Handler 类型必须是 func(c buffalo.Context) error
不是任意函数都能注册为路由处理器。Buffalo 严格要求 handler 必须符合 func(c buffalo.Context) error 签名,否则 app.GET("/path", MyHandler) 会编译失败或运行时报 cannot use ... as buffalo.Handler。
常见错误包括:
-
func MyHandler(c buffalo.Context) {}—— 缺少error返回值 -
func MyHandler(w http.ResponseWriter, r *http.Request)—— 用原生 HTTP 签名,Buffalo 不认 -
func MyHandler(c buffalo.Context, id string) error—— 多了参数,框架无法调用
函数名可以任意,但建议按语义命名(如 UsersShow、PostsCreate),便于团队理解意图。返回 nil 表示成功;返回非 nil error 会触发全局错误中间件(比如渲染 errors/500.html)。
怎么把自定义逻辑包装成合法的 Buffalo Handler
如果你已有普通 Go 函数(比如带多个参数或返回结构体),不能直接注册,得做一层适配:
- 用闭包捕获外部变量,内部再调用你的业务函数
- 所有输入必须从
c中提取:路径参数用c.Param("id"),查询参数用c.Param("q")或c.Request().URL.Query(),表单/JSON 用c.Bind(&v) - 输出必须走
c.Render()、c.Redirect()或c.Error(),不要碰http.ResponseWriter
例如,你想复用一个接收 id int 的函数:
func loadUserByID(id int) (*User, error) { /* ... */ }
<p>func UsersShow(c buffalo.Context) error {
idStr := c.Param("id")
id, err := strconv.Atoi(idStr)
if err != nil {
return c.Error(400, err)
}
u, err := loadUserByID(id)
if err != nil {
return c.Error(404, err)
}
c.Set("user", u)
return c.Render(200, r.HTML("users/show.html"))
}
</p>
为什么加了路由却 404 或 panic
最常被忽略的是:Buffalo 默认只注册 actions/*.go 下导出的函数,且要求文件里有 func App() *buffalo.App 并调用了 app.GET/POST 等方法。如果你把 handler 写在 handlers/ 目录或未导出函数里,它根本不会被扫描到。
- 确保 handler 函数首字母大写(导出)
- 确保它被显式注册在
app.Routes()里(通常在actions/app.go的App()函数中) - 检查
app.Use(...)中间件是否提前终止了请求(比如 auth 中间件返回 401 后没调用c.Next()) - 开发时运行
buffalo dev,它会自动 reload 并打印注册的全部路由;也可访问/debug/routes查看实时路由表
如何让同一个 handler 复用在多个路由上
Buffalo 允许一个 handler 被多次注册,但要注意上下文隔离:
- 每个请求都有独立的
buffalo.Context实例,不用担心并发污染 - 若需共享状态(如缓存、DB 连接池),应通过
app.WithValue(key, value)注入,再在 handler 中用c.App().Value(key)获取 - 避免在 handler 内部缓存 request-scoped 数据(如绑定后的结构体)到包级变量,这会导致数据错乱
例如,统一处理 API 和 Web 请求的 JSON 返回逻辑:
func APIResponse(c buffalo.Context, status int, data interface{}) error {
c.Response().Header().Set("Content-Type", "application/json")
return c.Render(status, r.JSON(data))
}
<p>func PostsIndex(c buffalo.Context) error {
posts := []Post{}
// ... 查询逻辑
return APIResponse(c, 200, posts)
}
</p>
这种封装没问题,但别把 posts 存成全局变量——那是并发不安全的雷区。











