Protoc-gen-validate校验不生效，主因是未启用插件、未导入validate包、未手动调用Validate()方法；需在gRPC handler首行显式校验并转换为status.Error。
Protoc-gen-validate 生成的校验代码不生效？检查是否启用了插件并正确 import
生成的 Validate 方法没被调用，大概率不是校验逻辑写错了，而是根本没走到校验入口。Protoc-gen-validate 只负责在 .proto 文件编译时，为每个 message 生成 Validate 方法，它不会自动注入到 gRPC server 或 client 的调用链里。
常见错误现象：Validate() 从不 panic，即使传入明显非法字段（如邮箱格式错、必填字段为空）也无反应。
- 确认 protoc 命令中显式启用了插件：
protoc --validate_out=. --go_out=. --go-grpc_out=. xxx.proto，且已安装protoc-gen-validate并在$PATH中 - 生成的 Go 文件里必须有
import "github.com/envoyproxy/protoc-gen-validate/validate"，否则Validate()方法内部调用的校验函数会缺失 - 生成文件中应存在类似
func (m *User) Validate() error { ... }，若无，说明插件未生效或 proto 未加option (validate.rules).enabled = true;
gRPC Server 端手动调用 Validate() 的位置和时机
校验必须由你主动触发，典型位置是 RPC handler 入口。不建议在 middleware 层统一做（因不同方法参数类型不同，泛型支持弱），也不建议在 client 发送前做（服务端仍需兜底）。
使用场景：HTTP/JSON gateway、gRPC-gateway、纯 gRPC server 都适用同一模式。
立即学习“go语言免费学习笔记（深入）”；
- 在 service 实现方法第一行调用：
if err := req.Validate(); err != nil { return nil, status.Error(codes.InvalidArgument, err.Error()) } - 注意
req是 protobuf 生成的 struct 指针，Validate()方法定义在值类型上，所以req为*User时可直接调用；若传入的是interface{}（如某些中间件），需先断言类型 - 不要忽略返回的
err—— Protoc-gen-validate 默认返回validation.Error，其Error()方法会拼接所有字段错误，但 message 不带 HTTP 状态码，需你自己转成 gRPCstatus.Error
required 字段、嵌套 message 和自定义规则的实际写法差异
proto 中看似简单的 required 关键字，在 proto3 里已被移除，必须靠 validate rules 显式声明。嵌套结构和自定义正则的写法稍有区别，容易漏掉关键修饰符。
- 基础非空：
string email = 1 [(validate.rules).string.email = true];—— 这会同时校验非空 + 格式，不需要额外加required - 真正 required 字段（如 ID）：
int64 id = 2 [(validate.rules).int64.gt = 0];，用gt/gte替代 “是否为零值” 判断，因为 int64 默认 0，不能只靠present - 嵌套 message 必须显式开启递归校验：
UserInfo info = 3 [(validate.rules).message.required = true];，否则info为 nil 不报错，info.Validate()也不会被调用 - 自定义正则要加
pattern且注意转义：string tag = 4 [(validate.rules).string.pattern = "^\w+$"];，Go 字符串字面量需双反斜杠
性能与兼容性：Validate() 调用开销和 protobuf 版本陷阱
每次调用 Validate() 都是纯内存遍历，无反射、无 panic 捕获（默认），实测单次耗时在纳秒级，但深度嵌套 + 大量正则匹配会线性上升。更大的坑在版本兼容性上。
- Protoc-gen-validate v0.6+ 默认启用
validate插件的lite模式，生成代码更小，但要求 protobuf runtime >= v1.28 —— 若你用的是老版google.golang.org/protobuf（如 v1.25），会导致Validate()编译失败或 panic - 正则引擎用的是 Go 标准库
regexp，不支持 PCRE 特性（如K、lookbehind），写 pattern 时得按 Go 的 regexp 规则来 - 如果 proto 中用了
oneof，validate rules 对其内部字段的约束不会自动继承，需单独为 each field 加 rule，否则 oneof 整体为 nil 时不会触发子字段校验
最常被忽略的一点：Validate() 返回的 error 是 validation.Error 类型，它实现了 FieldError() 方法，但很多日志中间件只打印 Error() 字符串，导致丢失具体出错字段路径 —— 调试时建议先用 fmt.Printf("%+v", err) 看完整结构。
