Iris框架表单验证怎么写？Validator库参数校验逻辑-Golang-PHP中文网

正确姿势是：定义带validate tag的结构体，用ctx.readform/readquery绑定数据，再显式调用validator.struct()校验；validator实例需复用，错误信息应遍历validationerrors提取字段和规则。

iris框架表单验证怎么写？validator库参数校验逻辑

iris 中用 `Validator` 做表单校验的正确姿势

iris 本身不内置 Validator，所谓 Validator 通常指第三方库（如 go-playground/validator）配合 iris 的 ctx.ReadForm 或结构体绑定使用。直接调 ctx.ReadForm(&v) 不会自动触发校验，必须显式调用 Validate.Struct(v)。

常见错误是以为加了 struct tag 就能自动报错——其实 iris 不拦截、不包装、不自动调用 validator，全靠你自己组织逻辑。

先定义带 validate tag 的结构体，比如：

type LoginForm struct {
    Username string `validate:"required,min=3,max=20"`
    Password string `validate:"required,min=6"`
}

在 handler 里手动绑定 + 校验：

v := validator.New()
form := new(LoginForm)
if err := ctx.ReadForm(form); err != nil {
    ctx.StatusCode(400)
    ctx.JSON(map[string]string{"error": "解析表单失败"})
    return
}
if err := v.Struct(form); err != nil {
    ctx.StatusCode(400)
    ctx.JSON(map[string]string{"error": err.Error()})
    return
}

注意 validator.New() 应该复用（比如定义为包级变量），不要每次请求都新建，否则性能损耗明显

struct tag 里哪些校验规则 iris 能识别？

iris 本身不解析 validate tag，它只负责把表单字段映射到 struct 字段。真正起作用的是你引入的 go-playground/validator 库——iris 完全透明，tag 写法和标准 validator 一致。

常用且稳妥的规则包括：required、email、url、min/max（对字符串是长度，对数字是数值）、oneof、gt/gte 等。别写 isemail 这种旧版写法，新版统一用 email。

Iris框架 12.2.5

Iris框架 12.2.5 版本源码包下载，适合需要 MVC Singleton 控制器、依赖注入字段控制和 debug 错误日志改进的开发者。

下载

required_if、required_with 这类条件校验可用，但要注意字段顺序：被依赖字段必须已赋值，否则可能跳过校验
自定义函数需通过 v.RegisterValidation 注册，且函数签名必须是 func(fl validator.FieldLevel) bool
嵌套 struct 默认不递归校验，要加 dive tag，例如：Profile *UserProfile `validate:"dive"`

为什么 `ctx.ReadQuery` 或 `ctx.URLParam` 不走 validator？

因为 ReadQuery 和 URLParam 返回的是原始字符串或基本类型，没有 struct 上下文，validator 没有载体可绑。想校验 URL 参数，得先转成 struct 再校验，或者手写 if 判断。

推荐做法：把 query 参数也定义进同一个 form struct，用 ctx.ReadQuery 绑定（它支持 struct tag 映射），再统一走 v.Struct：

type SearchForm struct {
    Q     string `form:"q" validate:"required,min=1,max=100"`
    Page  int    `form:"page" validate:"omitempty,gt=0,lte=1000"`
}
// ...
form := new(SearchForm)
if err := ctx.ReadQuery(form); err != nil { ... }
if err := v.Struct(form); err != nil { ... }

ReadQuery 和 ReadForm 都支持 form tag，优先级高于字段名，默认用字段名映射，但建议显式写 form:"xxx" 避免歧义
URLParam 是路径参数（如 /user/:id），类型固定为 string，iris 不做类型转换，也不支持 tag 校验，必须自己 strconv.Atoi 后再判断范围

校验失败时怎么返回友好的错误信息？

err.Error() 返回的是整段英文描述（如 Key: 'LoginForm.Username' Error:Field validation for 'Username' failed on the 'required' tag），前端很难解析。应该遍历 err.(validator.ValidationErrors) 提取字段名和规则名。

if err := v.Struct(form); err != nil {
    errs := err.(validator.ValidationErrors)
    errors := make(map[string]string)
    for _, e := range errs {
        field := e.Field() // "Username"
        rule := e.Tag()    // "required"
        switch rule {
        case "required":
            errors[field] = "此项必填"
        case "min":
            errors[field] = "长度不能少于 " + e.Param() + " 个字符"
        }
    }
    ctx.JSON(map[string]interface{}{"errors": errors})
}