structlevel 是官方支持的多字段联合校验方案，需在初始化后注册结构体级校验函数，通过 fl.currentstruct.interface() 获取完整结构体，用 fl.reporterror() 按字段名报错，且不中断后续校验。
为什么 validator 的内置标签搞不定联合校验
Go 的主流校验库（如 go-playground/validator）默认只支持单字段验证，比如 required、min=1。一旦要判断 “密码和确认密码必须一致” 或 “起始时间不能晚于结束时间”，内置标签就无能为力——它压根不提供跨字段上下文。
你可能会试 eqfield，但它只做字符串字面量相等，不支持转换、计算或业务逻辑（比如忽略大小写比对邮箱、按规则生成 token 后校验一致性）。真要落地，必须自己接管校验入口。
-
Validate.Struct()默认不传入结构体指针以外的上下文，没法塞额外参数 - 自定义函数若直接访问全局变量做状态判断，会破坏并发安全
- 用
RegisterValidation注册的函数，接收的是单个interface{}，拿不到同结构体其他字段
用 StructLevel 注册结构体级校验器
这是官方支持的多字段联动方案：把整个结构体当一个整体来验，校验函数能拿到所有字段值，也便于做依赖判断和错误归因。
关键不是写函数，而是注册时机和调用方式——必须在初始化 validator 实例后、首次校验前完成注册，且需显式启用 StructLevel 校验。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 校验函数签名固定：
func(fl validator.StructLevel)，其中fl.CurrentStruct.Interface()可转成目标结构体指针 - 错误必须通过
fl.ReportError(...)报出，第一个参数是字段名（用于定位），第二个是自定义错误 tag（如password_mismatch） - 别在函数里 panic，validator 会捕获并转为
ValidationErrors
type UserForm struct {
Password string `json:"password"`
ConfirmPwd string `json:"confirm_pwd"`
}
validate := validator.New()
validate.RegisterStructValidation(func(fl validator.StructLevel) {
u := fl.CurrentStruct.Interface().(*UserForm)
if u.Password != u.ConfirmPwd {
fl.ReportError(u.Password, "password", "Password", "password_mismatch")
}
}, UserForm{})
如何让联合校验支持动态条件（比如“仅当状态为 draft 时才校验截止日期”）
硬编码判断逻辑会污染结构体定义，也不利于测试。更稳妥的做法是把条件判断下沉到校验函数内部，靠字段值驱动分支，而不是靠外部传参。
结构体本身应包含足够信息——比如带状态字段、开关字段、类型标识。校验函数读取它们，再决定是否执行某段逻辑。这样既保持 validator 调用简洁，又避免引入不可控依赖。
- 不要试图往 validator 实例里塞 context 或 config，它不是设计来承载业务状态的
- 如果真需要外部输入（如当前登录用户角色），建议在校验前预处理结构体，把所需信息作为字段塞进去（例如加一个
CurrentRole string字段） - 注意字段零值陷阱：
int是 0、string是空、bool是 false，用IsZero()判断不如明确检查== ""或== 0
错误提示怎么绑定到具体字段而不污染结构体定义
fl.ReportError() 第一个参数必须是字段的原始名称（不是 JSON tag），否则 Errs[i].Field() 拿不到正确字段名，前端无法精准定位。很多人误传 u.ConfirmPwd 的值，结果报错显示成 “password_mismatch on 'abc123'”，完全失去意义。
- 正确传法：
fl.ReportError(reflect.ValueOf(u).FieldByName("ConfirmPwd").Interface(), "confirm_pwd", ...)——但太绕 - 推荐写法：用
fl.CreateError()+ 手动构造FieldError，或直接用fl.ReportError(nil, "confirm_pwd", ...)（nil 表示不校验值，只占位字段名） - 如果要用 JSON tag 显示名（如前端要求显示 “确认密码” 而非
confirm_pwd），得自己维护映射表，validator 不负责翻译
真正容易被忽略的点是：联合校验失败后，validator 仍会继续执行其他字段的单字段校验。如果你希望“密码不匹配”时跳过后续所有校验，得在外层手动控制流程，StructLevel 本身不提供中断机制。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
