validator校验不生效主因是字段未导出（首字母小写）或未调用Validate.Struct()；嵌套结构体需导出内层字段并加dive，time/int/切片等类型须规避零值语义陷阱。
validator 校验不生效，八成是字段没导出或没调用 Validate.Struct()；嵌套结构体漏校验、时间字段总过不了、指针字段 required 失效——这些问题都绕不开反射可访问性、标签顺序和触发时机这三个底层逻辑。
字段首字母小写导致 validate 标签完全被忽略
validator 依赖 reflect 读取字段值，而 Go 的反射只能访问导出字段（首字母大写）。哪怕 tag 写得再全，name string `validate:"required"` 这种写法下 name 字段根本不会进校验流程，也不报错、不警告。
- 错误写法：
type User struct { name string `validate:"required"` }→name被跳过 - 正确写法：
type User struct { Name string `json:"name" validate:"required"` } - 对接 JSON 时字段名需小写？保留
json:"user_name"，但结构体字段仍必须大写：UserName string `json:"user_name" validate:"required"` - 嵌套结构体同理：内层字段也必须导出，否则
validate:"required,structonly"也无效
Validate.Struct() 和 Validate.Var() 混用导致校验静默失效
两者触发机制完全不同：Validate.Struct() 能识别结构体字段上的 validate tag 并递归处理嵌套、omitempty、dive；Validate.Var() 只校验单个值，对字段上下文一无所知。
- 误用场景：
validate.Var(req, "required")→ 只检查req指针是否为 nil，完全不跑字段校验 - HTTP handler 中一律用
validate.Struct(req)，哪怕req是指针 - 务必提前判空：
if req == nil { return errors.New("request is nil") }，否则Validate.Struct(nil)会 panic - 单独校验某个动态字段（比如从 map 取出的值）才用
Validate.Var(value, "email")
嵌套结构体、切片、time.Time 的校验陷阱
这些类型在零值语义上和 required 天然冲突，不加干预就会漏检或误报。
立即学习“go语言免费学习笔记（深入）”；
-
time.Time零值是0001-01-01，validate:"required"不失败 → 改用validate:"required,datetime=2006-01-02"或自定义函数判断是否为零时间 -
int零值是0，required无效 → 若业务中0非法，改用validate:"gte=1"或validate:"ne=0" -
[]string空切片[]是合法值，required不报错 → 显式加validate:"min=1,dive,required"，注意dive必须紧跟在切片 tag 后，validate:"required,dive"顺序错就失效 - 嵌套结构体字段为指针（如
*Address），加validate:"omitempty"才能在其为nil时跳过子校验；普通结构体字段（如Address）即使全零也会触发内部校验
Gin 中 binding 和 validate 标签配合出错的典型表现
Gin 的 binding 标签负责解析，validate 标签负责校验，二者缺一不可，且依赖字段能被正确赋值。
-
binding:"required"不报错但字段为空？大概率是没加json:标签，导致 JSON 字段根本没绑定进来 →Username string `json:"username" binding:"required"` - GET 请求的 query 参数不能用
json:，得用form:或uri:；混用会导致字段始终为空 -
c.ShouldBindJSON()强制走 JSON 解析，适合明确知道是 JSON 的接口；c.ShouldBind()依赖Content-Type，header 错或缺失时可能 fallback 到 form 解析，把 JSON 当字符串丢掉 - 别在中间件里直接调
c.ShouldBindJSON()—— 非法 JSON 会 panic，应手动读 body +json.Unmarshal预检，再重置c.Request.Body
真正难的不是写对那几行 tag，而是理解 validator 只校验它能安全反射读到的字段、只在校验入口被显式调用时才启动、且对零值的判定完全取决于 Go 类型系统本身。任何想绕过这些前提去“自动校验”的尝试，最后都会变成 debug 场景里的定时炸弹。
