FieldMask 在 Go gRPC 中需手动调用 fieldmaskutil.StructToStruct 或 Mask 处理，否则服务端收不到值；paths 必须严格符合 proto 字段路径规范，空 UpdateMask 表示不更新任何字段，不可默认全量覆盖。
FieldMask 在 Go gRPC 接口中怎么传才不被忽略
gRPC 服务端默认不会自动解析 FieldMask，哪怕你定义了 google.protobuf.FieldMask 字段、客户端也发了，服务端收到的仍是空值——这是最常踩的坑。
根本原因是：Go 的 protobuf 生成代码里，FieldMask 是普通结构体字段，没有自带反序列化逻辑；gRPC 不会主动调用 Unmarshal 或做路径校验，它只负责把二进制 payload 解成 struct。
- 必须手动在 handler 里调用
fieldmaskutil.StructToStruct或fieldmaskutil.Mask做字段裁剪 - 客户端发的
paths必须是合法路径（如"user.name"、"items[].id"），不能带空格或非法字符，否则IsValid检查失败后整个 mask 被静默丢弃 - 如果请求体是
Any或嵌套深的结构，FieldMask路径必须和实际 proto 字段层级完全匹配，大小写、下划线都不能错
用 fieldmaskutil.Mask 实现部分更新的正确姿势
别直接改原始数据结构，要用 fieldmaskutil.Mask 把源 struct 按 mask 裁出子集，再 merge 到目标对象上。硬编码字段赋值等于放弃 FieldMask 的灵活性。
典型错误是：收到 update 请求后，拿 req.GetUpdateMask().GetPaths() 手动遍历路径、反射取值赋值——这既难维护又容易漏掉 repeated 字段或 oneof 分支。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 先用
fieldmaskutil.StructToStruct(req.GetUpdateMask(), req.GetResource(), &dst)把请求资源按 mask 复制到目标 struct - 注意
req.GetResource()必须是已解码的 struct（不是*anypb.Any），否则StructToStruct返回空 - 如果资源字段含
google.protobuf.Timestamp或Duration，需确保 proto 文件 import 正确且生成代码包含对应类型注册，否则裁剪时 panic
paths 字符串怎么写才符合规范
FieldMask.paths 看似简单，但写错一个点就导致整个 mask 失效，而且无报错、无日志、无声无息——这是调试时最耗时间的地方。
它不是 JSONPath，也不是 XPath，而是 proto 字段路径表达式，规则严格：
- 用英文点号
.分隔嵌套字段，如"profile.avatar_url" - repeated 字段用
[]表示索引通配，如"items[].name"（不能写"items[0].name"） - map 字段用
"map_field.key"形式，不支持"map_field['k']" - oneof 字段只能指定具体子字段，如
"data.string_value"，不能只写"data"
为什么 UpdateMask 为空时不能跳过处理
很多实现看到 req.GetUpdateMask() == nil || len(req.GetUpdateMask().GetPaths()) == 0 就直接 return，结果导致“全量更新”行为失控——这不是设计意图，而是 bug。
gRPC 规范明确：空 FieldMask 表示“不更新任何字段”，即本次请求应为只读操作（比如仅触发 side effect），而非 fallback 到全量覆盖。
- 必须显式判断
req.GetUpdateMask() == nil或len(req.GetUpdateMask().GetPaths()) == 0，并拒绝更新逻辑 - 如果业务真需要“空 mask = 全量更新”，那是协议层约定，得在文档里写死，并在 handler 开头加注释说明，不能当默认行为
- 测试时务必覆盖
update_mask: {}这种 case，用protoc-gen-go生成的 struct 默认不会初始化空 slice，所以GetPaths()可能返回nil而非空 slice
FieldMask 的难点不在语法，而在路径合法性检查、struct 层级对齐、空值语义理解这三个地方。少一个环节，接口就变成黑盒——看着成功，其实什么都没更新。
