安全参数校验必须结构体驱动+标签声明+显式触发+字段级错误返回：ShouldBind默认仅返首错且信息不友好；需手动处理query/path参数；嵌套与指针字段须特殊配置；错误响应须结构化并翻译。
直接用 json.Unmarshal 或 c.ShouldBind 不校验就往下走，等于裸奔。 安全、可维护、前端友好的参数校验必须结构体驱动 + 标签声明 + 显式触发 + 字段级错误返回，缺一不可。
为什么 c.ShouldBind 默认行为不能直接信
Gin 的 ShouldBind 确实集成了 validator，但默认只返回第一条错误，且错误信息是扁平字符串（如 "Key: 'User.Email' Error:Field validation for 'Email' failed on the 'email' tag"），不含字段路径和可读提示。前端无法精准标红对应输入框。
- 它不会自动展开嵌套结构体错误，
User.Profile.Name出错时你只看到User.Profile一级 - 不处理
omitempty和required冲突：字段为空时被跳过反序列化，required校验直接失败，但你不知道是没传还是传了空值 - 对
*string、*int这类指针字段，required默认不生效——它检查的是指针是否为nil，而非解引用后是否为空 - 错误堆栈里没有原始请求值，调试时得再翻日志或加断点
结构体定义必须同时满足 JSON 解析与校验语义
同一个结构体要兼顾 json 反序列化和 validate 规则，但二者 tag 名不同、职责分离，不能混用。
-
json:"name"控制字段如何从 JSON 键映射，validate:"required,min=2"控制业务规则，二者必须对齐，否则字段名不一致会导致校验失效 - 避免在字段上同时写
json:",omitempty"和validate:"required"——前者让空值不进结构体，后者要求字段非零，矛盾直接导致校验必败 - 嵌套结构体必须显式加
validate:"dive"，否则内层字段完全不参与校验；数组字段同理，[]string validate:"dive,min=1" - 时间字段别直接用
time.Time接字符串，先定义为string，再在自定义校验函数里解析并判断格式（如"2006-01-02"）
query 和 path 参数不能靠 ShouldBind 自动处理
ShouldBind 默认只处理 JSON body 和 form-data，对 URL query 和 path 参数无感知。它们是纯字符串，必须手动提取、转换、再校验。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 用
r.URL.Query().Get("page")拿 query 值，别用r.FormValue("page")——后者会隐式调用ParseForm()，干扰 multipart 解析 - 数字类 query（如
limit）必须用strconv.ParseInt(v, 10, 64)并检查err != nil，不能直接赋值或 fallback 默认值 - path 参数（如
/users/:id）用chi.URLParam(r, "id")或gorilla/mux.Vars(r)["id"]取出后，同样要转类型+范围校验，不能假设前端传的是整数 - 布尔 query（
?active=true）用strconv.ParseBool，别用字符串比对，否则漏掉"1"、"on"等合法变体
错误响应必须结构化到字段粒度
返回 {"error": "invalid request"} 对前端毫无价值。真正的字段级错误响应需提取 validator.ValidationErrors 中每个 FieldError 的关键信息。
- 用
err.(validator.ValidationErrors)类型断言获取错误切片 - 遍历每个
fe，调用fe.Field()得字段名（注意：是 struct 字段名，不是 JSON key），fe.Tag()得规则名（如"required"），fe.Value()得原始传入值 - 建议用 JSON tag 名（如
json:"email"）做映射键，而不是 struct 字段名，避免前后端字段名不一致导致前端找不到对应控件 - 不要直接返回英文错误，至少做基础翻译：
"required" → "不能为空"，"email" → "邮箱格式不正确"，复杂规则可封装成 map 查表
最容易被忽略的是：query/path 参数的类型转换失败必须立刻返回 400，而不是吞掉错误继续执行；还有就是自定义校验函数注册后，tag 名必须和注册名完全一致，否则整个规则静默失效——这种问题调试时极难定位。
