Skip to main content

gRPC（开发者）

gRPC 二进制 RPC。本工具不需要你预先准备 .proto——只要服务端开了 Server Reflection（反射），客户端就能自动发现服务和方法，再按需查看字段、发起调用。

核心流程​

界面怎么用（三步）​

以示例服务 qrtest.v1.EchoService 为例（grpc://127.0.0.1:18089，h2c 明文）：

  1. 连接 gRPC 请求（url 存 host:port）。连上后自动反射，得到方法树：
    • /qrtest.v1.EchoService/Echo —— 一元
    • /qrtest.v1.EchoService/EchoStream —— 服务端流
    • /qrtest.v1.EchoService/Collect —— 客户端流
    • /qrtest.v1.EchoService/Chat —— 双向流
  2. 查看方法 Echo 的 schema：
    • 入参 EchoRequest { message: string, count: int32 }
    • 出参 EchoResponse { message: string, seq: int64, metadataJson: string }
  3. 调用 Echo，消息填 {"message":"hello-grpc","count":3}：
    • 一元：返回一条 {message:"hello-grpc", seq, metadataJson}，状态 OK
    • 服务端流 EchoStream 同参数：返回 3 帧 stream#1/#2/#3

元数据（gRPC 头）​

认证/追踪用的头以 metadata 传，键会被小写化；grpc-*、content-type 等保留头会被过滤。

TLS / mTLS​

用 grpcs:// 前置 URL，并在设置里导入客户端证书。

注意事项（重要）​

  • 非 OK 状态是正常业务结果，不是连接故障：如超时、业务错误会以状态码带回、响应可能为空——别当传输失败处理。只有 HTTP 4xx 才是错误。
  • 工具只支持一元与服务端流两种调用；客户端流/双向流暂不可调（应用内如需完整流式以 UI 为准）。
  • 复杂类型：map 字段会呈现为 mapEntry 嵌套；被间接引用的类型也会一并带出。

相关：环境前置 URL 与 TLS 配置见 concepts。