gRPC反射需在服务端显式调用reflection.Register(s)启用，且必须在s.Serve()前注册；验证方式为grpcurl -plaintext localhost:8080 list，若返回服务列表则生效，否则提示Unimplemented错误。
Go 的 gRPC 反射（grpc.reflection）本身不提供“调试工具”，它只暴露服务定义元数据；想实现通用调试工具，核心不是开启反射，而是用反射获取的 ServiceDescriptor 构建动态请求构造器和响应解析器。
如何启用 gRPC 反射并验证是否生效
反射服务必须显式注册，且仅对 grpc.Server 生效，客户端默认不感知。常见错误是只在 server 端启用了但没用 grpcurl 或自研工具连接验证。
- 服务端注册：调用
reflection.Register(server)，必须在server.Serve()之前 - 验证命令：
grpcurl -plaintext localhost:8080 list—— 若返回空或报错rpc error: code = Unimplemented desc = Server does not implement reflection API，说明未注册或监听地址/端口不匹配 - 注意：gRPC-Web、TLS、Unix domain socket 场景下，
grpcurl默认不兼容，需加-protoset或改用grpcui
如何用 grpc-go 的 reflection API 获取服务方法列表
grpc.ReflectionClient 是客户端侧入口，但它不直接返回结构化方法列表，需配合 ServerReflectionClient 手动解析 FileDescriptorSet —— 这步最容易卡住，因为返回的是二进制 google.protobuf.FileDescriptorProto 序列化数据，不是 JSON 或 Go struct。
- 关键步骤：调用
client.ListServices()得到服务名列表 → 对每个服务名调用client.FileByFilename()或client.FileContainingSymbol()拿到*descriptorpb.FileDescriptorProto - 注意
FileDescriptorProto中的service字段是重复字段，每个ServiceDescriptorProto包含method列表，每个MethodDescriptorProto有input_type和output_type，指向message_type的 name - 别硬解嵌套路径：用
protoreflect.DescriptorPool加载所有FileDescriptorProto后，再通过FindDescriptorByName()查方法，否则类型引用会断链
如何动态构造请求消息并序列化
拿到 MethodDescriptorProto 后，不能直接 new 一个 struct——你不知道服务端用的是哪个 Go package 下的类型，更不知道字段 tag 是否一致。必须依赖 protoregistry.GlobalTypes 或本地构建 protoreflect.MessageDescriptor。
- 推荐路径：用
dynamicpb.NewMessage(method.InputType())创建空白消息实例，再用protojson.Unmarshal将用户输入的 JSON 注入（注意：JSON key 必须匹配 proto 的json_name，不是 Go 字段名） - 坑点：
optional字段、oneof、map<string, string>在 JSON 解析时行为特殊，protojson.UnmarshalOptions{DiscardUnknown: false}必须设为 false，否则缺失字段会静默丢弃 - 避免用
proto.Marshal直接序列化动态消息：它依赖protoreflect.Message实现，若 descriptor 来源不一致（比如跨 proto 文件未合并注册），会 panic “unknown field”
为什么不能只靠反射做完整调试工具
反射只提供 .proto 结构，不提供业务逻辑语义：默认值在哪定义、哪些字段必填、枚举合法值范围、超时建议、认证方式（API key / bearer token / TLS client cert）、重试策略——这些全得靠人工配置或额外注解（如 google.api.HttpRule 或自定义 option）补充。
真正可用的通用调试工具，至少要支持：粘贴 proto 内容手动加载、保存常用请求模板、展示 raw wire 格式（binary/base64）、标记字段是否已设置（vs 默认零值）。反射只是起点，不是终点。
