Buffalo通配符路径必须用{name*wildcard}格式，仅允许一个且置于末尾；通过c.Param("name")获取解码后的路径片段，需防范路径遍历。
Buffalo 路由中怎么写通配符路径
Buffalo 使用 github.com/gobuffalo/buffalo 的原生路由语法，通配符不是用 * 或 **，而是通过带 *wildcard 后缀的命名参数实现。它和普通命名参数（如 {id}）语法一致，但语义不同：匹配任意长度的剩余路径段。
正确写法是：/api/v1/files/{path*wildcard} —— 这会匹配 /api/v1/files/a/b/c.txt，且 c.Param("path") 返回 "a/b/c.txt"。
- 必须写成
{name*wildcard}格式，wildcard是固定关键字，不能省略或替换为其他词 - 通配符参数只能放在路径末尾，前面不能再有其他静态段（比如
/files/{p*wildcard}/meta是非法的） - 一个路由里最多只能有一个
*wildcard参数 - 如果路径以
/结尾（如/static/{p*wildcard}），而请求是/static/css/app.css，p值不含开头的/，即得"css/app.css"
怎么在 handler 里读取通配符参数值
和普通路径参数一样，用 c.Param("name") 获取，但要注意：它的值是 URL 解码后的原始路径片段，不包含查询参数（?q=1 部分需用 c.Request().URL.Query() 单独取）。
示例：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
app.GET("/assets/{file*wildcard}", func(c buffalo.Context) error {
filename := c.Param("file") // 如请求 /assets/js/main.js → filename == "js/main.js"
fullPath := filepath.Join("public", filename)
if _, err := os.Stat(fullPath); os.IsNotExist(err) {
return c.Error(404, err)
}
return c.File(fullPath)
})
- 不要对
filename再做url.PathEscape或filepath.Clean—— Buffalo 已做基础校验，但你仍需防御路径遍历（如../../../etc/passwd） - 若未注册该路由却访问了匹配路径，Buffalo 默认返回 404，不会 fallback 到其他 handler
-
c.Param返回空字符串时，说明路径刚好到通配符前结束（如/assets/→file == ""），需按业务逻辑判断是否合法
通配符和普通命名参数混用的边界情况
Buffalo 不允许在同一个路由里同时使用 {id} 和 {p*wildcard}，也不支持像 /user/{id}/posts/{slug*wildcard} 这类嵌套结构。一旦用了 *wildcard，它必须是最后一个参数，且前面所有段都得是静态或普通命名参数。
- ✅ 合法：
/admin/{section}/{item*wildcard}（section是普通参数，item是通配符） - ❌ 非法：
/api/{version}/users/{id}/{log*wildcard}/detail（通配符后还有静态段） - ❌ 非法：
/files/{a*wildcard}/{b*wildcard}（多个通配符） - 注意：如果想实现类似
/user/123/settings/profile的多级动态路由，应拆成多个独立路由，或统一用一个通配符再手动 split，例如/user/{rest*wildcard}，然后在 handler 中用strings.Split(c.Param("rest"), "/")解析
为什么通配符参数有时取不到值
最常见原因是路由注册顺序。Buffalo 按 routes/app.go 中定义的先后顺序匹配，如果上面有一条更宽泛的静态路由（如 app.GET("/assets", ...)）挡在 /assets/{p*wildcard} 前面，后者根本不会被触发。
- 检查
buffalo dev启动日志里的路由表，确认你的通配符路由确实已注册且位置合理 - 浏览器或 curl 访问时确保 URL 没有多余的结尾
/（除非路由本身以/结尾），否则可能被重定向或 404 - 如果用了自定义中间件，确认它没提前调用
c.Response().WriteHeader()或c.Render()，否则后续c.Param()可能不可靠（虽然通常不影响） - 通配符参数不参与方法（GET/POST）区分，但如果你为同一路径注册了多个方法 handler，要确保调用的是对应方法的那个
真正容易被忽略的是：*wildcard 匹配的是“路径段”，不是“完整 URL”——它不会吞掉查询参数或 fragment，也不会自动处理编码差异；你拿到的值已经是 Go 标准库 url.Parse 解码后的结果，但像 %2F 这种编码斜杠仍会变成 /，所以做文件系统操作前务必再次校验合法性。
