proto.Marshal/Unmarshal失败主因是协议不匹配：.proto文件版本不一致、struct字段tag编号与.proto定义不符、或gogoproto扩展与运行时版本不兼容；需逐项核对文件一致性、编号对应性及插件版本。
Go 里用 proto.Marshal 和 proto.Unmarshal 就能完成基本序列化，但字段编号错一位、.proto 和生成代码不一致、或误用指针/零值语义，都会导致静默失败或数据丢失——不是函数写错了，而是协议层根本对不上。
proto.Marshal 返回 unexpected EOF 或 invalid wire format 怎么查
这类错误几乎全是协议不匹配：发送方和接收方用的不是同一版 .proto，或者 Go struct 的 protobuf: tag 编号和 .proto 文件里定义的字段编号不一致。
- 先确认双方
.proto文件完全相同（包括注释行位置都最好一致，某些旧版 protoc 会把注释也算进哈希） - 检查 Go struct 字段 tag，比如
protobuf:"bytes,5,opt,name=body"中的5是否和.proto里bytes body = 5;完全对应 - 别信字段顺序——
proto解码只认编号，struct 里字段前后调换不影响行为，但编号错就直接解析失败 - 如果用的是 gogoproto 扩展，确认
protoc-gen-go版本与google.golang.org/protobuf运行时版本兼容（2026 年主流用v1.34+，别混用已弃用的github.com/golang/protobuf）
为什么字段值总是 nil 或空字符串
Protobuf 区分“未设置”和“设为零值”，Go struct 中 *string 类型字段为 nil 表示未设置，"" 才表示显式设为空。这和 JSON 完全不同，也是最容易踩坑的地方。
- 前端传了
{"user_name": ""}，后端收到User.Name == nil？检查.proto里字段是否声明为optional string name = 1;（proto3 默认所有字段 optional，但生成的 Go struct 仍可能用指针） - 想让空字符串也触发赋值，得在
.proto里加[(gogoproto.nullable) = false]，并确保用的是支持该扩展的插件版本 - 嵌套 message 字段解析成
nil，大概率是父 message 的字段编号写错，或子 message 的.proto没被正确 import（注意import "xxx.proto"路径必须能被-I参数覆盖）
protoc --go_out 报 plugin not found 怎么解决
这不是插件没装，而是 protoc 根本找不到 protoc-gen-go 可执行文件。它不查 $GOPATH/bin，也不自动遍历 $PATH，除非你显式告诉它位置。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 先运行
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest（注意不是github.com/golang/protobuf，那个已归档） - 确认
$(go env GOPATH)/bin在$PATH中，或直接指定路径：protoc --plugin=protoc-gen-go=$(which protoc-gen-go) --go_out=. example.proto -
--go_out参数末尾必须带:，比如--go_out=.或--go_out=paths=source_relative:./gen，漏掉会报错 - 生成的
.pb.go文件里 import 路径出错？用--go_opt=module=your-module-name控制，别手动改生成文件
JSON 反序列化失败，字段全为零怎么办
Go 的 protobuf 默认不支持 JSON 字段名映射。前端传 userName，proto 定义是 user_name，直接 json.Unmarshal 到 *YourMessage 会静默失败——字段不会被赋值，保持零值。
- 必须用
protojson.UnmarshalOptions，并开启DiscardUnknown: false和AllowPartial: true - 确保
.proto里字段有json_name选项，例如string user_name = 1 [json_name = "userName"]; - 别用
encoding/json直接解，它不认识 protobuf 的 tag；要用google.golang.org/protobuf/encoding/protojson包 - 如果 proto 文件没加
json_name，又不能改定义，只能先用protojson.Unmarshal解到 map，再手动映射到 struct 字段
最麻烦的点往往不在代码怎么写，而在于团队里多个服务用的 .proto 文件是否真的同步、编号是否有人手改过、以及生成代码后有没有人偷偷删掉 reserved 声明——这些地方一动，下游服务就可能开始返回零值，还查不出错在哪。
