Buffalo框架基础路由怎么建？第一个接口编写示例-Golang-PHP中文网

Buffalo路由必须在App()函数内通过app.GET()等方法显式注册到*buffalo.App实例，且Handler必须为func(c buffalo.Context) error类型，否则访问返回404。

buffalo框架基础路由怎么建？第一个接口编写示例

Buffalo 的路由不是写在 main.go 里，也不是靠独立 routes.go 文件自动加载——它必须注册进 app.Routes() 返回的 http.Handler 实例中，否则访问就是 404。

路由注册必须在 `actions/app.go` 的 `App()` 构建器内完成

Buffalo 把整个应用生命周期封装在 App() 函数返回的 *buffalo.App 实例里。所有路由都得挂在这个实例上，比如：

func App() *buffalo.App {
    app := buffalo.New(buffalo.Options{
        Env:         ENV,
        SessionName: "_myapp_session",
    })

    // ✅ 正确：在这里注册
    app.GET("/hello", HelloHandler)

    // ❌ 错误：放在这里没用（哪怕函数存在）
    // HelloHandler 不会自动被发现或绑定

    return app
}

app.GET()、app.POST() 等方法必须在 App() 函数体内调用，不能放到包级变量或 init() 中
如果你改了 actions/app.go 却没生效，先确认是否漏掉了 app.GET(...) 这一行
buffalo dev 启动时会调用 app.Routes()，它内部才真正把 app 实例转成可服务的 http.Handler

`HelloHandler` 必须是 `func(c buffalo.Context) error` 类型

Buffalo 不接受任何其他签名。常见错误包括：

写成 func HelloHandler(c buffalo.Context) {}（无返回值）→ 编译报错：cannot use HelloHandler as buffalo.Handler
写成 func HelloHandler(w http.ResponseWriter, r *http.Request)（原生 HTTP 签名）→ 路由注册失败，启动时报 panic
写成 func HelloHandler(c buffalo.Context, id int) error（多参数）→ 同样触发类型不匹配错误

正确写法：

Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载

func HelloHandler(c buffalo.Context) error {
    return c.Render(200, r.JSON(map[string]string{"msg": "hello"}))
}

成功必须返回 nil；非 nil error 会交由全局错误中间件处理（如渲染 errors/500.html）
不要直接操作 http.ResponseWriter，否则绕过 Buffalo 生命周期，可能卡住响应或 panic
如果想返回 JSON，用 r.JSON；HTML 模板则用 r.HTML("hello.html")，路径必须是 templates/hello.html（小写，无大写首字母）

为什么访问 `/hello` 返回空白页或 404？检查这三点

最常卡在这几个地方，而不是代码逻辑本身：

没执行 buffalo dev —— 它不是普通 go run main.go，必须用 CLI 启动才能加载 app.Routes()
HelloHandler 函数定义在别的文件但没被 import 进 actions/app.go（Go 包可见性问题）
模板路径写错：比如用了 r.HTML("Hello.html") 或 r.HTML("templates/hello.html")，Buffalo 只认 templates/hello.html（根目录起始，且文件名全小写）