动态路由必须在路径中显式声明参数占位符,如/users/:id,否则c.Params("id")始终为空;通配符*path须位于末尾且不可与:name混用;?仅支持末尾单段可选,如/posts/:id/:version?。

动态路由必须在路径中显式声明参数占位符
Fiber 不会自动从 URL 中提取路径段,c.Params("id") 要能取到值,前提是路由注册时路径里写了 :id。写成 /users/123 但注册的是 app.Get("/users", ...),c.Params("id") 永远返回空字符串。
常见错误是误以为路径含数字就自动识别为参数,结果调试半天发现 c.Params() 始终为空。正确写法是:
-
app.Get("/users/:id", handler)→c.Params("id")可取到"123" -
app.Get("/posts/:year/:month/:day", handler)→ 支持多级参数,顺序严格对应 -
app.Get("/files/:user/*path", handler)→ 启动报错invalid pattern,通配符*必须在末尾且不能和:name混用
可选路径段用 ? 标记,但只适用于末尾单段
? 表示该路径段可选,但它只能加在最后一个参数或静态段之后,不能出现在中间。比如 /api/v1/users/:id/profile? 是非法的;而 /posts/:id/:version? 是合法的——它匹配 /posts/123 和 /posts/123/v2 两种形式。
注意:这个 ? 不是正则语法,也不影响前面段的匹配逻辑,只是让引擎在解析时跳过该段。如果需要更灵活的可选行为(如任意位置可选),得拆成多个路由或改用查询参数。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
c.Params() 取值前先确认路由是否命中
即使路径写了 :id,如果请求没走到这个 handler(比如被中间件拦截、被更具体的路由覆盖、或 StrictRouting 导致末尾斜杠不匹配),c.Params("id") 也不会有值。典型陷阱:
- 注册了
app.Get("/users/:id", h),但请求是GET /users/123/→ 默认 StrictRouting 开启,404 - 同时注册了
/users/:id和/users/me,后者会被前者覆盖(因为:id是通配),/users/me永远取不到 -
c.Params()返回的是string,不是int,需手动转换:id, _ := strconv.Atoi(c.Params("id"))
运行时动态加路由要调用 RebuildTree()
开发期临时加路由(比如调试接口)可以调用 app.Get() 注册新路径,但**不会立即生效**——必须紧接着调用 app.RebuildTree() 才能让新路由进入前缀树。这是 Fiber v3 的明确设计,不是 bug。
但要注意:RebuildTree() 性能开销大,非线程安全,官方明确说“仅用于开发环境”。生产环境硬要用,得自己加锁 + 控制调用频次,否则高并发下可能 panic 或路由丢失。
最常被忽略的一点:重建后,新注册的 GET 路由会自动补上配套的 HEAD,不需要再手动 app.Head() —— 这是 Fiber 的默认行为,不是 bug,是 feature。


















