Buffalo路由404的真实原因是app.Routes()未被调用或执行,而非路由未定义;必须确保app.GET等注册语句在app.Routes()函数体内显式调用,并确认该函数被app.Serve()正确使用。

Buffalo 路由 404 的真实原因不是“没写路由”,而是 app.Routes() 没生效
你加了 app.GET("/hello", HelloHandler) 却访问返回 404,大概率不是路由写错了,而是 app.Routes() 函数根本没被调用,或者被条件逻辑跳过。Buffalo 的路由注册入口只在 app.Routes() 内部执行,它不是靠扫描文件或自动加载——你改了 actions/app.go,但没确认 app.Routes() 是否真被调用了。
检查方法很简单:启动时看日志有没有类似 INFO[0000] registered route GET /hello 这样的行。没有?说明 app.Routes() 没跑,或者里面漏掉了那行 app.GET 调用。
-
app.Routes()必须返回一个http.Handler,通常就是app.Serve()返回的那个;如果中间加了自定义中间件但忘了next.ServeHTTP(w, r),整个链就断了 - 别把路由写在
routes.go里——Buffalo 不读这个文件,它只认app.Routes()函数体内的显式调用 - 如果用了
app.Group("/api"),记得app.Group(...).GET(...)才会挂到子路径下,直接app.GET("/api/hello")是无效的
404 错误页怎么替换?别动 templates/errors/404.html 就完事
Buffalo 默认会找 templates/errors/404.html,但前提是你的 app.Templates 没被设为 nil。如果你做了 API 项目、禁用了模板系统(app.Templates = nil),那这个页面压根不会渲染,而是直接返回空响应或 panic。
所以换 404 页前,先确认你还在走 HTML 渲染流程:
- 删掉或注释掉
app.Templates = nil这行(如果存在) -
templates/errors/404.html必须存在,且不能有语法错误(比如引用了未定义的.User字段) - 模板里别用
c.Render(404, r.HTML(...))显式触发——Buffalo 会在找不到路由时自动 fallback 到这个模板,手动调用反而可能绕过逻辑 - 修改后要重启
buffalo dev,因为模板是预编译的,热重载不生效
想对 404 做定制逻辑?用中间件拦截,别改全局错误处理
Buffalo 的 app.ErrorHandlers 是全局的,改它会影响所有错误(500、422 等),容易误伤。真正干净的做法是写一个中间件,在路由匹配失败后介入:
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
app.Use(func(c buffalo.Context) error {
// 先让路由匹配
err := c.Next()
if err != nil && strings.Contains(err.Error(), "no route found") {
c.Response().Header().Set("Content-Type", "text/html; charset=utf-8")
c.Response().WriteHeader(404)
// 可以 render 自定义模板,或返回 JSON,或重定向
return c.Render(404, r.HTML("errors/custom_404.html"))
}
return err
})
注意顺序:这个中间件必须放在 app.Use(...) 链的末尾,否则会被前面的日志、auth 中间件提前捕获错误,你就收不到原始的 “no route found”。
- 别用正则去匹配
err.Error(),Buffalo 的错误字符串可能随版本微调;目前稳定的是包含"no route found" - 如果用了
app.Resource(),它的 404 是由 resource 自己控制的,中间件捕获不到,得进actions/users.go之类的具体 action 里手动处理 - 返回
c.Render()前,确保templates/errors/custom_404.html已存在且路径正确,否则又陷入嵌套 404
为什么本地 404,部署后却正常?public/ 目录和打包逻辑常被忽略
开发时 buffalo dev 能跑,但 buffalo build 后二进制运行却一堆 404,尤其是 /assets/xxx.js 或 /en/xxx 这类路径——这不是路由问题,是静态资源没打进包里。
Buffalo 的 buffalo build 只复制 public/ 目录下的文件,不编译也不生成。如果你没运行 Webpack、或者 public/assets/ 是空的,那生产环境自然 404。
- 执行
buffalo build前,务必先确保public/assets/和public/images/等目录非空 - 如果用了
packr/v2,记得先运行packr2生成packrd.go,再buffalo build,否则 box 不会被注入 - 别依赖
//go:embed public和packr.New混用——它们会冲突,导致资源加载失败但无提示
最隐蔽的坑是:你本地开发时 Webpack 自动构建,一切正常;一打包就暴露问题,而错误日志里只报 “file not found”,从不告诉你缺的是哪一层。


















