Fiber 框架不内置参数校验，需手动集成 go-playground/validator/v10：先 BodyParser 解析结构体，再调用 validate.Struct 校验，失败时统一返回结构化错误；不支持 @Valid 等 Spring 机制，因属不同语言生态。
Fiber 框架本身不内置 Validator，也没有类似 Spring Boot 的 @Valid 自动绑定和校验机制。它依赖中间件 + 手动调用校验库来实现参数校验，必须自己组装验证流程——这是最常被忽略的前提。
为什么 Fiber 不能直接用 @Valid 或 spring-boot-starter-validation
Fiber 是 Go 语言的轻量级 Web 框架，和 Java 的 Spring 生态完全无关：spring-boot-starter-validation、@Valid、BindingResult 这些全是 JVM 侧概念，在 Go 中根本不存在。试图“集成 Hibernate Validator”或“复用 JSR-303 注解”是方向性错误。
Go 生态里该选哪个 Validator 库
推荐用 go-playground/validator/v10（简称 validator.v10），它是 Go 社区事实标准，支持结构体标签校验、自定义函数、跨字段验证、错误翻译，且 Fiber 官方文档明确推荐它。
- 别用
github.com/asaskevich/govalidator：已归档，不维护，无泛型支持 - 别自己写正则+if判断：重复代码多、错误信息难统一、嵌套字段处理麻烦
- 注意导入路径是
github.com/go-playground/validator/v10，不是v9或无版本号路径（否则可能 panic）
怎么在 Fiber 路由中触发 validator.v10 校验
核心是：先 c.BodyParser(&dto) 解析请求体，再手动调用 validate.Struct(dto)，失败时用 c.Status(400).JSON() 返回错误。没有自动拦截、没有切面、不依赖反射注入。
示例：
type CreateUserRequest struct {
Name string `json:"name" validate:"required,min=2,max=20"`
Email string `json:"email" validate:"required,email"`
Age int `json:"age" validate:"required,gt=0,lt=150"`
}
<p>func CreateUser(c *fiber.Ctx) error {
var req CreateUserRequest
if err := c.BodyParser(&req); err != nil {
return c.Status(fiber.StatusBadRequest).JSON(fiber.Map{"error": "解析请求体失败"})
}</p><pre class="brush:php;toolbar:false;">if err := validator.New().Struct(req); err != nil {
// 把 validator.FieldError 转成可读 message
errMsgs := make([]string, 0)
for _, e := range err.(validator.ValidationErrors) {
errMsgs = append(errMsgs, e.Error())
}
return c.Status(fiber.StatusBadRequest).JSON(fiber.Map{"errors": errMsgs})
}
// 校验通过，继续业务逻辑
return c.Status(fiber.StatusCreated).JSON(fiber.Map{"id": 123})}
怎么复用校验逻辑并统一错误格式
不能靠“全局 AOP”，但可以封装一个中间件或工具函数。关键是把 validate.Struct() 提取为可复用方法，并支持自定义错误 key 映射（比如把 Name 字段转成 name 返回给前端）。
- 不要在每个 handler 里重复写
if err := validate.Struct(...) - 建议写一个
ValidateRequest(c *fiber.Ctx, target interface{}) error函数，内部完成解析 + 校验 + 错误标准化 - 如果要用国际化错误信息，需提前注册翻译器（
ut.RegisterTranslation），且必须在 validator 实例化后立即设置 - 嵌套结构体（如
Address字段）默认会递归校验，前提是该字段也打了validatetag；若想跳过，加validate:"-"
真正的难点不在“怎么写校验规则”，而在于 错误信息是否对前端友好、是否能准确定位到字段、是否支持多语言、是否和 OpenAPI 文档联动——这些都要手动对齐，Fiber 不帮你做。
