Fiber中通配符*必须位于路径末尾,否则启动时报invalid pattern错误;/files/:user/*path因*path后无段而合法,但若写成/v1/*version/users则因*version后还有/users而报错。

通配符路由在 Fiber 中只允许出现在路径末尾,写错位置会直接导致启动报错,不是运行时 404。
为什么 /files/:user/*path 启动就失败
Fiber 的路由解析器在构建基数树时会校验通配符位置。只要 * 不在路径最后一段(即后面还跟着其他段),就会触发 invalid pattern 错误。
-
/static/*filepath✅ 合法:通配段在末尾 -
/v1/*version/users❌ 报错:通配段后还有/users -
/api/:id/*✅ 合法:等价于/api/:id/*filepath,*是占位符,名称不影响匹配 -
/a*b/c❌ 不是通配符语法,这是字面路径,*和b被当作普通字符
c.Params("*") 怎么取值
通配符捕获的是从该段开始到路径结尾的全部内容(不含查询参数),且自动去除开头斜杠。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 请求
GET /user/avatar/123/head.png匹配app.Get("/user/*", handler) -
c.Params("*")返回"avatar/123/head.png",不是"/avatar/123/head.png" - 若用
app.Get("/user/*filepath", handler),效果完全一样,filepath只是变量名,不参与匹配逻辑 - 不能同时用
:id和*在同一级:比如/user/:id/*是合法的,但/user/*/:id会报错
通配符和可选参数别混用
? 在通配符后不起作用 —— /user/*? 不是“可选通配”,而是把 ? 当作字面字符,整段变成 /user/*? 这个静态路径。
- 想实现“有或没有通配部分”,得注册两条路由:
/user和/user/* -
/user/:section?是合法的,但这是命名参数可选,和通配无关 -
/user/+(加号)是贪婪必填参数,不是通配符,它只捕获单一段,不跨斜杠 - 真正需要“任意深度子路径”时,
*是唯一选择,别试图用+或正则模拟
通配符节点在基数树里永远排在子节点末尾,且一旦命中就终止查找 —— 它会覆盖同级所有其他节点,包括参数节点。这点容易被忽略:如果你先注册了 /files/:id,再注册 /files/*,后者会拦截所有 /files/xxx 请求,前者根本没机会执行。


















