Protobuf字段新增必须用optional或repeated修饰，禁止使用required；删除字段需reserved而非移除；字段编号、类型及oneof归属不得变更，否则破坏二进制兼容性。
Protobuf 字段必须用 optional 或 repeated 修饰才能安全增减字段
Go 中 Protobuf 兼容性不靠语言特性兜底，而依赖 .proto 文件的定义方式。只要新旧版本消息结构满足「向后兼容」（旧代码能解析新消息）和「向前兼容」（新代码能解析旧消息），protoc-gen-go 生成的 Go 结构体就能自动处理缺失或多余字段。
关键约束是：所有新增字段必须设为 optional（v3 默认行为，但需显式声明或确保未设 required）或 repeated；不得修改已有字段的 field number、类型或是否为 oneof 成员；删除字段只能标记为 reserved，不能直接移除。
-
int32字段升级成int64会破坏二进制兼容——序列化字节流长度和解码逻辑都不同 - 如果旧版用了
required（v2 语法），新版去掉该字段会导致解析失败；v3 已弃用required，但若混用 v2/v3 插件可能出问题 - 使用
oneof时，新增分支没问题，但不能把已有字段挪进oneof块——这会改变 wire encoding
Go 侧需禁用 DiscardUnknown 并检查 XXX_Unrecognized
默认情况下，proto.Unmarshal 会静默丢弃未知字段（即新版本加的字段，旧版解析时不认识）。这看似“能跑”，实则掩盖兼容性风险：一旦旧服务误判字段含义或下游依赖字段存在性，就会出错。
正确做法是在反序列化时保留未知字段，并主动校验：
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 用
proto.UnmarshalOptions{DiscardUnknown: false}替代裸调proto.Unmarshal - 生成的 struct 里有
XXX_Unrecognized []byte字段（启用gogoproto插件时可能叫XXX_unrecognized），可据此判断是否收到未知字段 - 线上可打点统计
len(msg.XXX_Unrecognized) > 0的比例，作为版本灰度依据
示例：
opt := proto.UnmarshalOptions{DiscardUnknown: false}
if err := opt.Unmarshal(data, &msg); err != nil {
return err
}
if len(msg.XXX_Unrecognized) > 0 {
log.Warn("received unknown fields")
}
升级 gRPC 接口时，proto.RegisterFile 和 proto.FileDescriptor 要同步更新
gRPC 服务端/客户端运行时依赖 Protobuf 的 descriptor 信息做反射和编解码。如果只更新 .proto 文件、重新生成 Go 代码，但没更新 proto.RegisterFile 注册的 descriptor，可能出现「字段存在但无法被反射读取」的问题，尤其在使用 grpc-gateway 或自定义中间件时。
- 确认生成代码中包含类似
proto.RegisterFile("user.proto", fileDescriptor_user)的注册调用 - 检查
fileDescriptor_user变量是否随 .proto 修改而更新（某些旧版protoc-gen-go不自动刷新该变量） - 若用
buf工具链，确保buf generate输出含完整 descriptor 注册逻辑
常见错误现象：grpc.Invoke 成功但响应 struct 字段全零值，proto.GetProperties 查不到新增字段——大概率是 descriptor 未刷新。
测试兼容性不能只靠单元测试，得用真实 wire 格式比对
写个 TestOldClientNewServer 没用，因为 Go struct 初始化默认零值，容易掩盖字段缺失问题。真正要验证的是二进制 wire 格式层面能否互通。
- 用旧版代码序列化一条消息，保存
[]byte到文件；再用新版代码反序列化它，检查关键字段是否非零且无 panic - 反过来，用新版代码序列化含新增字段的消息，交给旧版代码解析，确认不 panic、旧字段可读、新增字段被忽略（而非崩溃）
- 注意：Protobuf v3 对
nilslice/map 的编码行为与 v2 不同，跨 major 版本测试时务必确认 protoc 和插件版本一致
最容易被忽略的是 time.Time 和 duration 这类包装类型——它们底层是 int64 + 单位，但 Go 生成代码里带额外的 marshal 方法，版本不一致时可能触发 panic 而非静默失败。
