grpcurl可调用gRPC反射但Postman/Insomnia报12:Unimplemented问题排查

问题原因 #

• 服务未开启gRPC反射：grpcurl能正常交互是因为它支持通过反射自动识别服务接口，但Postman、Insomnia这类GUI工具默认依赖反射来获取服务定义。如果你的gRPC服务没启用反射，工具找不到对应方法，就会返回12: Unimplemented。
• 请求方法格式错误：手动输入的gRPC方法名不完整，正确格式应该是包名.服务名/方法名（比如helloworld.Greeter/SayHello），如果只写SayHello，工具无法定位到具体实现。
• TLS配置不匹配：虽然你的服务没使用TLS，但Postman/Insomnia可能默认开启了TLS验证，导致连接协议不兼容，间接触发错误。

解决办法 #

• 启用服务反射：在服务代码中添加反射支持，比如：
  • Go语言：导入google.golang.org/grpc/reflection，启动服务时调用reflection.Register(grpcServer)；
  • Java：添加io.grpc:grpc-reflection依赖，注册ReflectionService到gRPC服务器。
• 修正请求方法格式：严格按照包名.服务名/方法名的格式填写请求方法，不要省略包名和服务名。
• 关闭工具的TLS验证：
  • Postman：打开gRPC请求的「Advanced」设置，勾选「Disable TLS」；
  • Insomnia：在请求设置里找到TLS相关选项，关闭「Enable TLS」或者勾选「Skip TLS Verification」。
• 手动导入.proto文件：如果不想开启反射，可以把服务的.proto文件直接导入到Postman/Insomnia中，让工具直接获取接口定义，无需依赖反射。

内容的提问来源于stack exchange，提问作者guy mograbi