资讯动态

grpcurl:一条命令搞定 gRPC 调试

发布时间:2026/8/23 13:36:57 来源:尧图企业网站定制
grpcurl一条命令搞定 gRPC 调试【免费下载链接】grpcurlLike cURL, but for gRPC: Command-line tool for interacting with gRPC servers项目地址: https://gitcode.com/gh_mirrors/gr/grpcurlgRPC 服务明明开着curl 却打不通抓包全是二进制用 grpcurl 把 gRPC 调试拉回终端装好工具、调通方法、看回 JSON不用写一行客户端代码。30 秒装好 grpcurl 并跑通 gRPC 调试平台安装方式Windows从项目 Release 页下载 zip 包解压后把grpcurl.exe加入 PATHmacOSbrew install grpcurlLinuxsnap install grpcurl或docker pull fullstorydev/grpcurl:latest已有 Go 环境可跳过上表直接go install github.com/fullstorydev/grpcurl/cmd/grpcurllatest一条命令装好。装完立刻对一台开了 server reflection 的服务敲第一条命令grpcurl -plaintext localhost:50051 list-plaintext表示走明文连接、跳过 TLS。输出里会列出服务器上所有服务名看到结果就说明链路通了。grpcurl 高频命令速查命令说明grpcurl localhost:8787 list my.pkg.Service列出某个服务的全部方法grpcurl -d {id:1} host:443 my.pkg.Service/Method传 JSON 请求体调用方法grpcurl -d host:443 my.pkg.Service/Method req.json从文件或 stdin 读请求体grpcurl -H authorization: Bearer tkn host:443 ...附加请求头常用于认证grpcurl -plaintext host:80 my.pkg.Service/Method明文连接跳过证书校验grpcurl host:443 describe my.pkg.Service/Method打印方法的完整 proto 定义注意所有 flag 必须放在host:port和方法名前面放后面会直接报错。进阶三个容易卡住的场景服务器没开反射怎么办grpcurl 默认靠 server reflection 拿 schema反射一关就会报Failed to list services。把.proto源文件直接喂给它grpcurl -import-path ./protos -proto my-service.proto -plaintext localhost:50051 list-import-path指向 proto 文件所在目录有依赖就多加几个-proto指定入口文件。把远端服务结构导出成本地 proto想离线看定义、或者生成客户端代码一条命令把远端 schema 落盘grpcurl -plaintext -proto-out-dir ./out_protos localhost:8787 describe my.pkg.Service导出文件在./out_protos下可以直接丢进 IDE 或交给protoc继续处理。流式响应怎么接client-streaming 方法用-d 从 stdin 逐条喂请求每行一个 JSON 对象双向流直接在交互式终端里持续输入grpcurl 会把每条 stdin 当作一帧发出去echo {name:alice} | grpcurl -plaintext localhost:50051 my.pkg.Service/Chat -d 排错小抄connection refused→ 端口写错或服务没监听 →ss -tlnp | grep 50051确认端口别把 TLS 和-plaintext混用。Failed to list services: Unavailable→ 服务端没注册 reflection service → 改用-proto-import-path本地喂 schema。x509: certificate signed by unknown authority→ 自签证书未被信任 → 调试时加-insecure正式环境用-ca-certs指定 CA 文件。unexpected argument→ flag 放在了 host 或方法名后面 → 把所有参数挪到host:port左边。完整 flag 列表跑grpcurl -help即可查看全部版本变更跟踪 releasing/RELEASE_NOTES.md。【免费下载链接】grpcurlLike cURL, but for gRPC: Command-line tool for interacting with gRPC servers项目地址: https://gitcode.com/gh_mirrors/gr/grpcurl创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价