17370845950

应使用 go-playground/validator 库，它支持标签驱动、嵌套校验和自定义规则，且无运行时依赖；避免使用已归档的 asaskevich/govalidator。

结构体字段验证该用哪个库

Go 标准库不提供字段级验证，encoding/json 和 reflect 仅支持基础序列化与反射，不做校验。生产项目普遍用 go-playground/validator，它支持标签驱动、嵌套结构、自定义规则，且无运行时依赖。别用 asaskevich/govalidator —— 已归档，不维护，Validate 方法在 Go 1.21+ 下有 panic 风险。

validator 标签怎么写才不出错

标签必须写在 struct 字段后、反引号内，且不能拼错字段名或参数。常见错误是把 required 写成 require，或漏掉 json 标签导致反序列化后字段为空但验证跳过。

type User struct {
    ID     int    `json:"id" validate:"required,gt=0"`
    Name   string `json:"name" validate:"required,min=2,max=20"`
    Email  string `json:"email" validate:"required,email"`
    Age    uint8  `json:"age" validate:"gte=0,lte=150"`
}

• required 只检查零值（""、0、nil），对指针字段要加 omitempty 或用 required_if
• email 不校验 DNS 或 MX 记录，只做格式正则匹配
• 嵌套结构需在字段上加 validate:"required"，并在类型定义里也加 validator 标签，否则 Struct 不递归校验

验证失败后怎么拿具体字段和错误

直接调 Validate.Struct() 返回 error，但它是封装过的 validator.ValidationErrors 类型，不能用 fmt.Errorf 直接打印字段名。必须类型断言并遍历：

err := validate.Struct(user)
if err != nil {
    if errs, ok := err.(validator.ValidationErrors); ok {
        for _, e := range errs {
            fmt.Printf("field: %s, tag: %s, value: %v\n", e.Field(), e.Tag(), e.Value())
        }
    }
}

• e.Field() 返回结构体字段名（如 "Name"），不是 JSON key（"name"）
• e.Param() 可取 min、max 等参数值，用于动态提示
• 若需返回 HTTP 错误，建议映射为 map[string]string：键用 e.StructNamespace() 提取路径（如 "User.Email"），避免前端无法定位嵌套字段

自定义验证函数怎么注册和触发

比如限制手机号必须是大陆 11 位数字，不能只靠正则标签——得注册函数，并在 tag 中引用函数名：

validate.RegisterValidation("chinese_mobile", func(fl validator.FieldLevel) bool {
    s := fl.Field().String()
    return regexp.MustCompile(`^1[3-9]\d{9}$`).MatchString(s)
})

// 使用
type User struct {
    Mobile string `validate:"chinese_mobile"`
}

• 函数名必须全小写，tag 中也写小写，否则注册无效
• fl.Field() 返回 reflect.Value，对指针字段要先 fl.Field().Elem()
• 不要在验证函数里 panic，validator 不 recover；出错应返回 false，错误信息靠 RegisterTranslation 补充

最易被忽略的是：validator 默认不校验 nil 指针字段，哪怕你写了 required。如果字段是 *string，必须显式加 nonnil 标签，或改用 required_with 组合逻辑。