用go-playground/validator/v10做结构体校验最省心：通过validate标签声明规则，需字段导出、显式调用validate.struct()，并全局配置errorhandler统一返回格式，支持query/body/form多源绑定与错误映射。
用 go-playground/validator 做结构体参数校验
直接在 Handler 里手动 if 判断字段长度或类型，既啰嗦又难维护。Fiber 本身不内置校验器，但和 go-playground/validator/v10 配合非常自然——关键在于把请求数据绑定到带 tag 的 struct 后统一校验。
步骤很简单：Query/Body 读值 → 映射到 struct → 调用 Validate.Struct()。注意 struct 字段必须首字母大写（否则反射不可见），tag 用 validate 键，比如 json:"email" validate:"required,email"。
- GET 参数校验：用
c.Query("email")拿单个值，或c.Queries()拿 map 后手动赋值；更推荐定义 struct +c.QueryParser(&v) - JSON Body 校验：直接
c.BodyParser(&v)，它会自动调用Validate.Struct()（前提是已注册 validator） - 表单（
application/x-www-form-urlencoded）：用c.FormValue("name")或c.BodyParser(&v)，后者要求 struct tag 匹配 form key，如form:"username"
校验失败时返回自定义错误格式
默认 BodyParser 遇到校验失败会返回 400 + 空响应体，前端很难解析。必须提前注册全局 validator 并设置 ErrorHandler，才能控制输出结构。
在 fiber.New() 初始化时传入配置：
app := fiber.New(fiber.Config{
ErrorHandler: func(c fiber.Ctx, err error) error {
var ve validator.ValidationErrors
if errors.As(err, &ve) {
// 转成 map[string]string 格式，key 是字段名，value 是提示
errs := make(map[string]string)
for _, e := range ve {
errs[e.Field()] = e.Error()
}
return c.Status(fiber.StatusBadRequest).JSON(fiber.Map{
"code": 400,
"msg": "validation failed",
"errors": errs,
})
}
return c.Status(fiber.StatusInternalServerError).SendString("server error")
},
})
注意：errors.As(err, &ve) 是判断是否为 validator 错误的唯一可靠方式，别用 strings.Contains(err.Error(), "Key:") 这类字符串匹配。
Query、Params、Header 混合校验怎么处理
Fiber 不支持像 Gin 那样一个 struct 同时绑定 query + path + header。你得手动组合——先定义校验 struct，再分别从 c.Query()、c.Params()、c.Get() 取值并赋给 struct 字段，最后调用 Validate.Struct()。
常见陷阱：
-
c.Params("id")返回的是 string，但 struct 字段是int，必须显式strconv.Atoi转换后再赋值，否则校验永远跳过数字规则（如min=1） -
c.Get("X-User-ID")获取 Header 值时，大小写不敏感，但validator对字段名严格区分大小写，struct 字段名要和变量名一致（如UserID对应UserID字段） - 如果某字段同时出现在 query 和 body 中（比如分页接口的
page），以你最后赋值的那个为准，没有自动合并逻辑
性能与边界场景要注意什么
validator 本身很快，但反复反射解析 struct + tag 仍有开销。线上高频接口建议做两件事：
- 对固定路径参数（如
/user/:id）优先用路由约束（app.Get("/user/:id<int>", ...)</int>），比运行时校验快一个数量级 - 避免在 validator 函数里做网络调用或 DB 查询——它设计为同步轻量校验，超时或 panic 会导致整个请求失败
- 数组参数（如
?ids=1&ids=2&ids=3）需用[]int字段 +validate:"required,min=1,dive,gt=0"，dive是必须的，否则只校验切片本身是否为空
最易被忽略的是：validator 的 required 对零值字段（如 int 字段值为 0）默认不触发，除非加 omitempty 或改用指针类型 *int —— 这点和前端传参习惯经常冲突。
