app.GET("/users", UsersList)与app.Resource("/users", UsersResource)冲突,因后者自动注册全部RESTful路由,导致重复注册GET /users而panic;应删手动路由或全手动注册。

为什么app.GET("/users", UsersList)和app.Resource("/users", UsersResource)会冲突
Buffalo 的 app.Resource() 会自动注册全部 RESTful 路由,包括 GET /users、GET /users/{id}、POST /users 等。如果你再手动写 app.GET("/users", UsersList),就等于注册了两次相同路径 + 相同方法的 handler,Buffalo 在启动时会 panic 报错:panic: route GET /users already registered。
常见错误场景:
- 用
buffalo generate resource users生成后,又手写一个同名app.GET("/users", ...) - 在
routes/app.go中多次调用app.Resource("users", ...) - 把
app.Resource("/api/users", ...)和app.Resource("/users", ...)混用,但没注意前缀是否已覆盖
解决办法只有两个:
- 删掉重复的手动
app.GET,只保留app.Resource; - 或者不用
app.Resource,全手动注册(app.GET、app.POST等),确保路径不重叠。
带可选参数的路由如/users/:id?匹配失败怎么办
Buffalo v1+ 对可选路径参数(:id?)的解析更严格,它不会 fallback 到下一个匹配的路由。比如你写了:
app.GET("/users/:id?", UsersShow)
app.GET("/users/new", UsersNew)
那么访问 /users/new 时,Buffalo 会先尝试匹配 /users/:id?,把 new 当作 id 值传入,根本不会走到第二条路由。
这不是 bug,是 v1 的明确行为变更。v0.18.x 可能“碰巧”走对了,但 v1 不再容忍这种模糊匹配。
正确做法是显式拆开:
app.GET("/users", UsersList)app.GET("/users/new", UsersNew)-
app.GET("/users/{id}", UsersShow)(用{id}替代:id?)
别依赖 ? 后缀做逻辑分发;Buffalo 不支持像 Express 那样的“通配后 fallback”机制。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
OPTIONS 路由被其他 handler 拦截导致跨域失效
浏览器发跨域请求前必先发 OPTIONS /api/users 预检。如果你只注册了 app.GET("/api/users", ...),而没单独注册 app.Options("/api/*x", ...),Buffalo 就找不到匹配的 handler,直接返回 404 —— 此时连中间件都不会触发,前端控制台只显示 No 'Access-Control-Allow-Origin' header,但后端日志里压根没这条请求记录。
关键点在于:Buffalo 的路由匹配是精确的,app.Options("/api/*x") 必须显式存在,且必须放在所有业务路由之前(推荐写在 routes/app.go 最顶部)。
容易踩的坑:
- 误以为
app.Use(middleware.CORS())能覆盖 OPTIONS —— 它不能,中间件链根本不执行; - 写成
app.Options("/api/users", ...)只覆盖单个路径,漏掉/api/users/123等子路径; - 在 OPTIONS handler 里调用了
c.Render()或c.JSON()—— 这会导致http: multiple response.WriteHeader calls,必须只设 header 并return nil。
自定义中间件修改了 c.Param() 导致后续 handler 取不到值
Buffalo 的 c.Param("id") 值来自路由匹配结果,不是从 URL 解析出来的。如果你在中间件里做了类似 c.Request().URL.Path = "/users/abc" 这种操作,c.Param("id") 仍返回原始匹配值(比如 "123"),不会自动刷新。
更隐蔽的问题是:某些中间件(如旧版 middleware.ParameterLogger)会提前调用 c.Request().ParseForm(),这会影响后续 handler 对 c.Request().PostForm 的读取 —— 因为 ParseForm() 只能调一次,第二次调用会静默失败或 panic。
所以中间件里除非必要,不要碰 c.Request() 的任何解析方法。如果真要改参数,应该用 c.WithValue() 显式注入新值,并让 handler 主动读取,而不是试图篡改原始上下文状态。










