protobuf v1.28+ 彻底移除了 proto.Message 接口，导致 func handle(m proto.Message) 编译报错 undefined；必须改用 protoreflect.Message，通过 msg.ProtoReflect() 获取，并导入 google.golang.org/protobuf/reflect/protoreflect。
protobuf v1.26+ 里 proto.Message 为什么报错 undefined
因为 proto.Message 接口在 google.golang.org/protobuf v1.28+ 中已被彻底移除，不是弃用警告，而是直接删除。如果你的函数签名还写着 func handle(m proto.Message)，编译器会报 undefined: proto.Message。
必须改用 protoreflect.Message，并导入 google.golang.org/protobuf/reflect/protoreflect。注意：这不是类型别名，而是全新接口，ProtoReflect() 才是获取它的入口。
- 旧写法：
msg.XXX_MessageName()→ 新写法：msg.ProtoReflect().Descriptor().FullName() - 旧写法：
msg.XXX_IsNil()→ 新写法：msg.ProtoReflect().IsValid() == false - 若无法立刻改函数签名，可用适配器桥接：
handle(msg.ProtoReflect())，但务必加if msg == nil判断，否则nil.ProtoReflect()panic
prototext.MarshalTextString 迁移到哪个函数
proto.MarshalTextString 和 prototext.MarshalTextString 都已废弃，v1.26+ 起必须用 prototext.MarshalOptions{} 实例调用 Format() 方法。
导入路径是 google.golang.org/protobuf/encoding/prototext，不是旧的 github.com/golang/protobuf/ptypes/... 。旧包即使还在 vendor 里，也不再兼容新 runtime。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 旧写法：
proto.MarshalTextString(msg) - 新写法：
prototext.MarshalOptions{}.Format(msg) - 如需缩进或忽略空字段，可设字段：
prototext.MarshalOptions{Indent: " ", EmitUnpopulated: false} - 注意：
Format()返回string，而Marshal()返回[]byte和 error —— 别混淆
XXX_ 方法全失效，怎么安全访问 Descriptor
所有生成代码里的 XXX_MessageName、XXX_DiscardUnknown、XXX_Unmarshal 等方法，在新版 protoc-gen-go 输出中不再存在。调用它们会直接编译失败，不是运行时错误。
Descriptor 访问必须统一收口到 ProtoReflect()，且要处理 nil 安全边界——nil 消息调用 ProtoReflect() 会 panic，必须提前判空。
- 获取全名：
if msg != nil { name := msg.ProtoReflect().Descriptor().FullName() } - 反序列化：
proto.UnmarshalOptions{}替代旧proto.Unmarshal，推荐显式控制DiscardUnknown: true - 扩展字段操作：
myExtField.Get(msg.ProtoReflect())，前提是myExtField是protoreflect.ExtensionType类型，且已在init()中注册 - 别试图保留 XXX_ 方法签名——生成器不输出，强行补会导致构建失败
go.mod 里 require 的 protobuf 版本怎么同步升级
仅更新 go.mod 里的版本号不够。必须同时升级三样东西：protoc 编译器、protoc-gen-go 插件、以及 runtime 包（google.golang.org/protobuf），缺一不可。
常见坑是 runtime 升了，但插件还是旧版，导致生成的 pb.go 仍含 XXX_ 方法，或调用 ProtoReflect() 返回 nil。
- 检查 protoc 版本：
protoc --version≥ 3.21（支持新反射 API） - 升级插件：
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest - 升级 runtime：
go get google.golang.org/protobuf@v1.32.0（当前最新稳定版） - 重新生成代码：
protoc --go_out=. --go_opt=paths=source_relative your.proto - 运行
go mod tidy确保所有依赖版本对齐，尤其注意google.golang.org/protobuf不要被间接依赖拉低
最易被忽略的是 protoc-gen-go 和 protoc 的 ABI 兼容性——哪怕只差一个小版本，也可能生成出调用 ProtoReflect() 但返回 nil 的代码，调试时很难定位。
