Fiber中路径参数、查询参数、请求体参数内存隔离,必须按来源区分取值:c.Params()仅取路由声明的路径参数且大小写敏感;c.QueryParam()专用于URL查询参数;请求体需依Content-Type用c.FormValue、c.BodyParser或c.FormFile。

c.Params() 只能取路由里显式声明的路径参数
你写 app.Get("/user/:id", handler),c.Params("id") 才能拿到值;如果路由是 /user/123 但没声明 :id,或者写成 /user/{id}(Fiber 不识别大括号语法),c.Params("id") 永远返回空字符串。
- 大小写敏感:
c.Params("ID")≠c.Params("id") - 末尾多斜杠不匹配:
/user/123/不会进入/user/:id路由,除非你加通配符或关闭StrictRouting -
*path返回带前导/的字符串,+path不带,但两者都只能用c.Params("*")或c.Params("+")取 - 多个参数推荐用
c.ParamsValues("year", "month", "slug"),比循环调c.Params()更安全、更少出错
c.QueryParam() 是读 ?key=value 的唯一正解
c.QueryParam("format") 和 c.Params("format") 完全无关——前者解析 URL 查询串,后者解析路径占位符。它们底层指向不同内存块,强行互换只会返回空。
- URL 是
/post/abc?format=json:c.Params("slug")→"abc"(前提是路由为/post/:slug),c.QueryParam("format")→"json",c.QueryParam("slug")→ 空(query 里没这个 key) - 推荐统一用
c.QueryParam(),它对缺失 key 返回空字符串,而c.Query()会 panic - 如果需要默认值,自己判空:
val := c.QueryParam("page"); if val == "" { val = "1" }
请求体参数必须按 Content-Type 选方法,不能硬套
表单、JSON、文件上传的解析逻辑完全不同,Fiber 提供了专用接口,混用会导致丢数据、panic 或解析失败。
- 表单(
application/x-www-form-urlencoded):c.FormValue("field"),多值用c.FormValues("tags") - JSON(
application/json):c.BodyParser(&data),结构体字段必须带json:"name"tag - 文件上传(
multipart/form-data):c.FormFile("file")+c.SaveFile(),别用c.Body()手动读,会破坏 multipart 解析状态 -
c.Body()只能调一次;需多次使用时,先bytes.NewReader(c.Body())重置流
高并发下别存 c.Params() 或 c.Body() 的返回值引用
fiber.Ctx 是复用对象,c.Params("id") 返回的是内部字节切片的引用,不是新分配的字符串。goroutine、map 或结构体字段里直接存它,下一个请求进来时值就变了。
- 错误写法:
id := c.Params("id"); go process(id)→id可能在 goroutine 执行前就被覆盖 - 正确做法:立即转成字符串或拷贝字节:
id := string([]byte(c.Params("id"))),或用strconv.Atoi后存 int - 同理,
c.Body()返回的[]byte也不能长期持有,尤其在中间件里打印完 body 后要手动重置流供后续 handler 使用


















