PROVIDER - 命令行调试 gRPC 服务

grpcurl

grpcurl 用 1 条命令调用 gRPC 服务且无需生成客户端代码,支持反射列出 2 类以上服务与方法,兼容 JSON 输入输出并支持 TLS、mTLS 与自定义头 3 类鉴权场景,BSD 开源单二进制跨平台;不足是仅支持 gRPC、流式调用学习成本高。

开发工具 美国 2026.11.19
4.1分

详细说明

优势 5 项

用 1 条命令调用 gRPC 服务,无需生成客户端代码
支持反射模式,可直接列出 2 类以上服务与方法信息
兼容 JSON 输入输出,与 REST 工具的 2 类使用习惯衔接
支持 TLS、mTLS 与自定义头,覆盖 3 类常见鉴权场景
以 BSD 许可开源,1 个单二进制即可跨平台运行

不足 4 项

仅面向 gRPC,不支持 REST 与 GraphQL
流式调用参数较多,学习成本偏高
无图形界面,团队共享用例不便
依赖服务端开启反射或提供 proto 文件

服务商概述

grpcurl 是 Fullstory 开源的 gRPC 命令行客户端,用类似 curl 的方式调用 gRPC 服务。

在开发工具分类里,它属于「接口调试工具」:补齐 gRPC 生态缺少轻量命令行客户端的空白。

核心优势

  • 零代码调用:1 条命令发起请求
  • 反射支持:无需 proto 也可探索
  • JSON 友好:输入输出易读
  • 鉴权覆盖:TLS 与 mTLS 可用
  • 单二进制:部署无依赖

产品生态

平台能力

服务与方法列举、请求描述、一元与流式调用、JSON 与 proto 双向转换、TLS 与头部配置、以及错误码详情解析。

集成

可与 kubectl 端口转发、Docker、CI 脚本以及服务网格调试流程配合。

典型场景

微服务接口排查、gRPC 服务冒烟测试、Kubernetes 内服务验证、认证链路调试。

不足之处

  • 协议范围:仅 gRPC
  • 学习成本:流式调用参数较多
  • 无 GUI:团队共享不便
  • 前置条件:需反射或 proto

适用场景

  • gRPC 快速排查(★★★★★):核心场景
  • 集群内服务验证(★★★★☆):配合端口转发很顺手
  • CI 冒烟测试(★★★★☆):脚本化容易
  • REST 接口调试(★☆☆☆☆):不适用

价格参考

项目 价格 备注
grpcurl $0 BSD 许可,开源免费
安装方式 $0 brew、go install、二进制下载
使用成本 $0 无许可或席位限制

常见问题

服务没有开启反射怎么办?

可以通过 -proto 指定 proto 文件或导入路径。

支持流式调用吗?

支持客户端流、服务端流与双向流。

能在 Kubernetes 里用吗?

常配合 kubectl port-forward 使用,也可在 Pod 内直接调用。

与 grpcui 的关系?

grpcui 提供图形界面,二者同属一个项目家族。

代码示例

# 列出服务(需服务端开启反射)
grpcurl -plaintext localhost:50051 list

# 描述某个方法
grpcurl -plaintext localhost:50051 describe demo.OrderService.GetOrder

# 发起一次调用
grpcurl -plaintext -d '{"id": 1}' localhost:50051 demo.OrderService/GetOrder

# 带 TLS 与自定义头
grpcurl -H 'Authorization: Bearer <token>' \
  api.example.com:443 demo.OrderService/GetOrder
# 配合 Kubernetes 端口转发
kubectl port-forward svc/order-api 50051:50051 &
grpcurl -plaintext -d '{"id": 1}' localhost:50051 demo.OrderService/GetOrder

社区与资源

  • 源码仓库:https://github.com/fullstorydev/grpcurl
  • 官方文档:https://github.com/fullstorydev/grpcurl/blob/master/README.md
  • gRPC 官方站点:https://grpc.io/
前往 grpcurl 官网 → https://github.com/fullstorydev/grpcurl
访问官网 ↗