Fiber框架中路径参数需手动转换类型并校验,c.Params()返回字符串且不自动解析;BodyParser仅解码不校验,需手动验证字段合法性;Query与Body须分开处理,所有校验失败后必须显式return。

路径参数必须手动取 + 转类型,c.Params() 不自动校验
Fiber 从不自动把 /user/:id 中的 id 解析成整数或校验格式——c.Params("id") 返回的永远是字符串,哪怕 URL 是 /user/123。你得自己调 strconv.Atoi(c.Params("id")) 并检查 err,否则传个 /user/abc 进来,Atoi panic 或后续逻辑用 0 当 ID 写进 DB。
常见错误:在 handler 开头写 id := c.Params("id") 就直接当 int 用;或用 fmt.Sscanf 硬解析,其实完全没必要——c.Params() 已是干净字符串,直接转就行。
容易踩的坑:
-
c.Params("id")返回的是底层字节切片引用,不能直接赋值给结构体字段(如u.ID = c.Params("id")),高并发下可能被下一个请求覆盖 - 没做空值判断:
c.Params("id")对未匹配路由返回空字符串,Atoi("")返回 0 和err != nil,但若漏判err,就拿 0 当合法 ID 用了 - Fiber v2 没
RegisterCustomConstraint,别指望/user/{id:[0-9]+}这种写法生效,它等价于/user/:id
c.BodyParser() 只解码,不校验字段合法性
c.BodyParser(&v) 成功只代表 JSON 或表单能反序列化,不代表数据合法。比如结构体 Title string `json:"title"`,前端 POST {"title":""},BodyParser 仍返回 nil 错误,但 v.Title 是空字符串——而业务上这可能是非法输入。
立即学习“go语言免费学习笔记(深入)”;
必须在 BodyParser 后立刻加显式判断:
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
if v.Title == "" { return c.Status(400).JSON(fiber.Map{"error": "title is required"}) }- 数字字段别信字符串内容,
strconv.ParseInt(c.Query("limit"), 10, 64)才可靠,c.Query("limit")返回空字符串时ParseInt会报错 - 表单提交要用
application/x-www-form-urlencoded+form:"name"tag,不是json:"name";JSON 请求必须带Content-Type: application/json,否则BodyParser静默失败
想用 go-playground/validator,得手动配 app.Validator
Fiber 默认完全忽略 validate:"required" 这类 tag。c.ShouldBind() 只认 binding:"required",且默认 validator 实例根本不调用第三方库。真要用 validator/v10,必须在 fiber.New() 之后、注册路由之前,显式赋值:
app.Validator = &customValidator{validator: validator.New()}
其中 customValidator 要实现 binding.StructValidator 接口,关键点:
-
ValidateStruct方法里调v.ValidateStruct(s),错误要用fe.Field()(对应 JSON key)而非fe.StructField()(Go 字段名) -
eqfield在嵌套 struct 中默认不跨层级,比如User.Profile.Password和User.ConfirmPassword,validate:"eqfield=Password"会在Profile里找Password,不是User层 -
required对" "或"\t\n"完全放行,得组合min=1或注册notblank自定义规则,内部先strings.TrimSpace()
Query 参数和 Body 必须分开处理,没有混合绑定机制
Fiber 不会帮你把 ?page=1&limit=10 和 POST {"name":"foo"} 合并进同一个结构体。它们是独立数据源:c.QueryParam("page") 取查询参数,c.BodyParser(&body) 解析请求体,c.FormValue("file") 拿表单字段——混用必为空。
典型场景:GET /api/posts?sort=created_at&limit=20 + 要求 body 带 {"tags":["go"]}(虽少见但 API 允许)。这时:
-
limit, _ := strconv.Atoi(c.QueryParam("limit")),别塞进结构体再 bind - body 结构体字段必须带
json:"tags"tag,否则c.BodyParser()不识别 - 校验都得手写:
if len(body.Tags) == 0、if limit 100,Fiber v3 仍无内置 binding tag 支持
最易被忽略的一点:所有校验失败后必须显式 return,否则 handler 继续执行,可能把非法数据写进数据库或触发 panic。Fiber 不会自动中断流程——它只管路由分发,不管业务逻辑是否安全。

















