validate标签不生效的主因是字段未导出（首字母小写）或未显式调用校验函数；嵌套结构需加“dive”，指针字段需配合required和nil检查；web框架中解码后须手动校验，不可依赖绑定自带校验。
为什么 validate 标签不生效？常见校验被跳过的原因
结构体字段加了 validate 标签但没报错，大概率是字段不可导出（首字母小写）或校验器没被调用。Go 的反射只能访问导出字段，validator 包默认不处理非导出字段。
- 确保字段名首字母大写，例如
Username string `validate:"required"`，而不是username string - 校验必须显式调用，比如
validate.Struct(req)，不能只靠标签就自动触发 - 嵌套结构体需额外加
validate:"dive"，否则内层字段校验被忽略 - 指针字段（如
*string）为空时，默认跳过校验；需要validate:"required"+nil检查逻辑配合
Web 请求中如何安全绑定并校验 JSON 参数（Gin / Echo / net/http）
直接用 json.Unmarshal 或框架 Bind 方法解码后，必须立即校验——否则可能把非法数据传进业务逻辑。
- Gin 中：先
c.ShouldBindJSON(&req)，再validate.Struct(req)；不要依赖c.BindJSON自带的简单校验，它不支持自定义规则 - Echo 中：
err := c.Bind(&req)只做类型转换，不校验，后续仍需validate.Struct(req) - 原生
net/http：用json.NewDecoder(r.Body).Decode(&req)后，必须手动校验，且注意r.Body只能读一次 - 建议在中间件统一处理校验失败，返回标准错误格式，避免每个 handler 重复写
if err != nil
required_if 和 oneof 这类条件校验怎么写才不出错
条件校验容易因字段顺序、空值判断或类型不匹配而静默失效。
-
required_if要求比较字段必须存在且非零，例如Status string `validate:"oneof=draft published"`+Reason string `validate:"required_if=Status published"`，如果Status是空字符串，Reason不会触发校验 -
oneof对字符串严格匹配，大小写敏感；数值型字段需用oneof=1 2 3，不能写成oneof="1 2 3" - 多个条件组合用
required_with或required_without，比嵌套required_if更可靠 - 时间字段慎用
datetime，优先用iso8601或自定义函数验证，避免时区/格式歧义
性能和兼容性：校验器初始化与复用的坑
每次请求都新建 validator.Validate 实例会浪费内存和 CPU；但全局单例又可能因并发导致 panic（旧版 v9 有此问题）。
立即学习“go语言免费学习笔记（深入）”；
- 使用 v10+ 版本，
validator.New()返回的实例是并发安全的，应作为全局变量复用 - 注册自定义函数（如手机号校验）必须在初始化时完成，运行时注册不生效
- 禁用结构体缓存（
SetStructValidationFunc）会导致每次校验都反射解析 tag，QPS 下降明显 - 对高频接口，可预编译校验规则：用
validate.StructCtx+ 上下文取消机制，防止恶意长请求阻塞
nil 指针、时间戳精度、UTF-8 非法字符。别只信文档里的例子，拿生产流量里的实际参数去压一遍 validate.Struct。 
