GoFrame接口参数校验需通过g.Validator().Data(指针).Run(ctx)链式调用触发,结构体v标签仅声明规则但不自动生效;必须传结构体指针,缺任一环节则校验静默失效。

在GoFrame项目中实现接口参数校验,必须让请求数据经过g.Validator()链式校验流程,否则即使结构体打了v标签也不会触发任何校验逻辑。
用结构体标签声明校验规则
定义请求结构体时,在字段后添加v:"规则"标签,例如required|min:6表示该字段必填且最小值为6。
GoFrame会自动识别v标签并提取规则,但仅当结构体被传入Validator().Data().Run()流程时才真正生效。
注意:v标签中的#后面是自定义错误提示,不写则使用框架默认文案。
这一步操作起来很简单,直接把v标签加到struct字段后面就行,但漏掉Data()或Run()调用会导致整个校验静默失效。
执行结构体校验的三步链式调用
第一步:调用g.Validator()获取校验器实例。
第二步:用.Data(结构体指针)绑定待校验数据,【必须传指针,传值会导致校验跳过】。
第三步:调用.Run(ctx)触发校验并返回error,ctx可传gctx.New()或从请求中提取。
完整调用链为:g.Validator().Data(obj).Run(ctx),缺一不可;中间不能插入其他非链式方法,否则会中断校验流程。
常用内置校验规则速查
required:字段非空(对string判空,对int判0,对指针判nil)。
min:10 / max:100:数值范围限制,支持int/float/string长度。
between:1,100:等价于min:1|max:100,但更简洁。
一款AI工具,主要用于Monitor and clean up invalid Codex authentication files in CPA. Check quota status, disable files returning 401 errors, and perform dual verification before deletion.,适合需要提升相关任务效率的用户。
email / phone / passport:格式类校验,自动匹配正则。
enums:admin,user,guest:v2.5+新增,校验字符串是否在枚举列表中。
length:6,16:字符串长度区间,两个数字间用英文逗号分隔。
自定义校验规则(函数式)
方法一:使用g.Validator().Rules()传入自定义规则字符串。
方法二:注册全局规则函数,调用gvalid.RegisterRule("is_upper", func(value interface{}) bool { return strings.ToUpper(fmt.Sprintf("%v", value)) == fmt.Sprintf("%v", value) })。
方法三:在结构体字段v标签中直接内联函数,如v:"@func:myCheck",然后通过gvalid.RegisterRule注册myCheck函数。
注意:自定义规则函数必须返回bool,且不能panic,否则校验流程会中断。
处理可选字段与零值陷阱
若字段v标签中不含required*类规则,且值为nil或空字符串,则跳过该校验——这是GoFrame的可选校验机制。
但整型字段值为0、布尔字段值为false时,仍会进入校验流程,【不会被跳过】。
因此对ID类字段慎用int类型,建议改用*int或uint,避免0值误触校验规则。










