Echo 默认不自动校验结构体字段，因其 Bind 方法仅做类型转换而不调用 validator；需手动注入实现 validator.Interface 的自定义校验器，并在 handler 中 Bind 后调用 c.Validate() 才生效。
为什么 Echo 默认不自动校验结构体字段
Echo 本身不内置 validator 实例，它只提供 Bind 方法做类型转换，但不触发校验逻辑。你写 binding:"required" 这类 tag，Echo 不会主动调用 go-playground/validator/v10 去检查——除非你手动集成或替换默认的校验器。常见现象是：结构体绑定成功了，但空字段、非法邮箱、超长字符串全被放过，直到业务层才发现问题。
根本原因在于 Echo 的 Bind 是纯解码行为（类似 json.Unmarshal），而 validator 是独立库，两者默认无耦合。必须显式桥接。
在 Echo 中正确注册全局 validator 实例
别在每个 handler 里手动调 validate.Struct()，那样重复且易漏。Echo v4 支持通过 e.Validator 字段注入自定义校验器，这是统一入口。
- 先初始化 validator 实例：
v := validator.New() - 注册自定义规则（如唯一性、跨字段约束）时，用
v.RegisterValidation("unique", uniqueFunc)，注意函数签名必须是func(fl validator.FieldLevel) bool - 赋值给 Echo 实例：
e.Validator = &CustomValidator{v: v}，其中CustomValidator需实现validator.Interface接口（重点重写ValidateStruct方法） - 不要直接用
validator.New()赋值——Echo 期望的是实现了接口的类型，不是裸指针
Bind 后立即校验，而非 Bind 前或中间件里盲目拦截
错误做法：在中间件里对所有请求无差别调 c.Bind(&req) 再校验。这会导致：未匹配路由的请求也被解析、非 JSON 请求 panic、绑定失败时错误信息丢失。
正确时机永远是 handler 内部，在 c.Bind() 成功之后：
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
func createUser(c echo.Context) error {
var req CreateUserRequest
if err := c.Bind(&req); err != nil {
return c.JSON(400, map[string]string{"error": "parse failed"})
}
if err := c.Validate(&req); err != nil {
return c.JSON(400, map[string]string{"error": err.Error()})
}
// 后续逻辑
}
注意：c.Validate() 是 Echo 提供的快捷方法，它会调用你注入的 e.Validator 实例；若没注入，则 panic。
关键点：只有 Bind 完成后，结构体字段才真正从请求中填充完毕（包括零值、类型转换结果），此时校验才有意义。比如 int 字段默认为 0，但业务上可能要求非零——这个判断只能在校验阶段做，不能靠 Bind 自动过滤。
嵌套结构、切片、跨字段校验的坑与绕过方式
原生 tag 对复杂场景支持有限，几个高频翻车点：
-
dive必须显式加在切片字段 tag 上，否则[]User里的每个User不会被递归校验；但dive不处理空 slice 或 nil slice，需提前判空 -
unique类校验函数里，若切片元素是 struct，v.Index(i).Interface()可能 panic（因含不可比较字段如map或slice）；安全做法是只取可比较字段（如 ID）去重，或用json.Marshal序列化后作 map key -
gtfield=EndDate这类跨字段比较，依赖字段在结构体中声明顺序——如果StartDate在EndDate后面，校验会误报；建议用ltefield/gtefield配对，并确保时间字段都用time.Time类型 - 嵌套结构体字段为指针（如
*Address）时，required不生效；得改用required_with=Address或自定义函数判断Address != nil
最麻烦的其实是错误信息定位——validator 默认返回聚合错误，但 Echo 的 c.Validate() 不拆解 ValidationErrors。若要返回字段级错误（如 {"Email": "invalid format"}），必须在 CustomValidator.ValidateStruct 里手动遍历并构造 map，不能依赖原生输出。
