c.Params() 仅能获取路由字符串中显式声明的路径参数,如 app.Get("/user/:id", h) 中的 ":id",未声明则返回空;通配符 * 必须在路径末尾,且 c.Params() 与 c.QueryParam() 数据源不同,不可混用。

c.Params() 只能取到显式声明的路径参数,其他地方写的 :id 一律无效
路由字符串里没写 :name,c.Params("name") 永远是空
路径参数不是靠 URL 自动识别的,而是靠你在 app.Get() 等方法的路径字符串里显式写出占位符。没声明,c.Params() 就拿不到值。
-
app.Get("/user/:id", handler)→c.Params("id")返回"123" -
app.Get("/user/{id}", handler)→ 404,Fiber 不识别大括号语法 -
app.Get("/user/:id/", handler)→ 匹配/user/123/,但不匹配/user/123(StrictRouting 默认开启) -
app.Get("/files/*", handler)→ 通配符必须在末尾,c.Params("*")返回路径剩余部分,如/files/a/b/c→"a/b/c"
别把 c.Params() 和 c.QueryParam() 当成一回事
它们读的是完全不同的数据源:c.Params() 来自路径段,c.QueryParam() 来自 URL 查询串,内存地址都不一样,混用必为空。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 请求 URL 是
/post/abc?format=json,且路由为app.Get("/post/:slug", handler):-
c.Params("slug")→"abc" -
c.QueryParam("format")→"json" -
c.QueryParam("slug")→ 空(query string 里没slug=) -
c.Params("format")→ 空(路径里没声明:format)
-
- 推荐统一用
c.QueryParam("key")而非c.Query("key"),前者对缺失 key 返回空字符串,后者可能 panic
多层动态路径别硬塞通配符,拆成多个命名参数
Fiber 的路由解析是线性单次匹配,不支持正则回溯,通配符 * 必须在路径末尾,否则启动报错 invalid pattern。
- ❌ 错误写法:
/api/v2/:version/users/:id/*path——*path不在末尾,启动失败 - ❌ 错误写法:
/v1//:id——:和:id冲突,引擎无法解析 - ✅ 正确写法:
/api/:version/users/:id/:section,按需提取各段 - ✅ 替代方案:用
/api/:version/*+c.Params("*")手动切分,但要自己做路径解析逻辑
goroutine 里别直接存 c.Params() 返回的字符串
c.Params() 返回的是内部字节切片的引用,不是新分配的字符串。Fiber 复用 fiber.Ctx 对象,下一个请求进来时值就变了。
- ❌ 危险写法:
id := c.Params("id"); go process(id)→id可能在 goroutine 执行前就被覆盖 - ✅ 安全写法:
id := string(c.Params("id"))或id := c.Params("id")后立刻转成字符串再传入 goroutine - 同理,
c.Body()也只能调一次;若需多次使用,先bytes.Copy()拷贝再用bytes.NewReader()重置
最常被忽略的一点:StrictRouting 开启时,/users 和 /users/ 是两条独立路由。只注册前者,后者必然 404——这不是 bug,是设计。别急着关 StrictRouting,先检查你的路由注册是否完整。


















