Buffalo 的 /*x 是唯一通配符,仅支持路径末尾、不解析参数、不兼容 RESTful 语法;需手动截取 c.Request().URL.Path 获取子路径,OPTIONS 预检须显式注册且不可调用渲染方法。

Buffalo 的 /*x 是通配符,不是正则,不能写 /api/** 或 /user/{id:int}
Buffalo 不用 gorilla/mux 那套语法,也不支持 RESTful 参数解析。它的通配符只有一种写法:/*x,且必须放在路径末尾。比如 /api/*x 能匹配 /api/users、/api/posts/123/edit,但 /api/users/*x 会报错——Buffalo 解析器不认这种嵌套通配。
它底层用的是 http.ServeMux 的变体,*x 只是一个占位变量名,你写 /*anything 效果一样,但惯例都用 x。
常见错误:
- 误以为
/*x能捕获路径片段:它不提供c.Param("x"),你得自己从c.Request().URL.Path截取 - 在
app.GET("/users/*x", handler)后又注册app.GET("/users/123", otherHandler):后者永远不会被调用,因为/*x优先级更高且已全覆盖 - 把
/*x放在根路径/*x:这会劫持所有请求(包括/assets/xxx.css),导致静态资源 404
/*x 路由里怎么拿到原始路径?别用 c.Param(),改用 c.Request().URL.Path
Buffalo 的 /*x 不绑定参数,c.Param("x") 返回空字符串。你要还原子路径,只能手动处理 c.Request().URL.Path。
例如注册了 app.GET("/api/*x", apiProxy),请求 GET /api/v1/users?limit=10:
-
c.Request().URL.Path是/api/v1/users - 你想提取
v1/users,就得做字符串切片:strings.TrimPrefix(c.Request().URL.Path, "/api/") - 注意不要用
path.Base()或path.Dir(),它们对 URL 路径不安全(比如含..时行为异常)
如果你需要类似 /users/{id} 的语义,Buffalo 原生不支持——得自己 parse 路径,或换用 github.com/gorilla/mux + Buffalo 的 app.Use() 手动接管路由。
OPTIONS 预检必须用 /*x 显式注册,且不能调用 c.Render()
跨域场景下,浏览器对 /api/*x 下所有路径发 OPTIONS 请求,但 Buffalo 不自动响应。你必须单独注册一条:
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
app.Options("/api/*x", func(c buffalo.Context) error {
c.Response().Header().Set("Access-Control-Allow-Origin", "http://localhost:3000")
c.Response().Header().Set("Access-Control-Allow-Methods", "GET,POST,PUT,DELETE,OPTIONS")
c.Response().Header().Set("Access-Control-Allow-Headers", "Content-Type,Authorization")
c.Response().Header().Set("Access-Control-Allow-Credentials", "true")
return nil // 关键:不能 c.Render(),不能 c.JSON(),不能 WriteHeader()
})
这个 return nil 会让 Buffalo 默认返回 200 状态码;一旦调用 c.Render(200, nil),内部就会触发 WriteHeader(),后续 Header().Set() 全部失效——浏览器收不到 CORS 头,但控制台不报错,只静默失败。
别图省事写成全局 /*x,比如 app.Options("/*x", ...):它会拦截 /buffalo_routes、/debug/pprof 等管理端点,带来安全隐患。
通配符路由和中间件的顺序很关键,app.Use() 必须在 app.GET() 之前
Buffalo 的中间件链是注册时决定的,不是运行时动态插入。如果你把 app.Use(corsMiddleware) 写在所有 app.GET() 之后,那中间件根本不会执行。
更隐蔽的问题是:中间件里调用 c.Render() 或 c.JSON() 会提前写 header,导致后续 handler 里再设 CORS 头无效。所以真正安全的做法是——
- 删掉所有
app.Use(middleware.CORS),它对 API 路由无效 - 把跨域逻辑下沉到每个 handler 开头,或封装成函数复用
- 若坚持用中间件,确保它只操作
Header()、不调用任何渲染方法,并且注册位置严格在路由之前
最容易被忽略的一点:Buffalo 的 c.Error() 也会触发 WriteHeader()。哪怕你在中间件里没写 c.Render(),只要某处调用了 c.Error(401, err),后面就再也设不了 CORS 头了。










