前言
一般情况下测试 gRPC 服务,都是通过客户端来直接请求服务端。如果客户端还没准备好的话,也可以使用 BloomRPC 这样的 GUI 客户端。
如果环境不支持安装这种 GUI 客户端的话,那么有没有一种工具,类似于 curl
这样的,直接通过终端,在命令行发起请求呢?
答案肯定是有的,就是本文要介绍的 grpcurl
。
gRPC Server
首先来写一个简单的 gRPC Server:
helloworld.proto
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
syntax = "proto3" ; package proto; // The greeting service definition. service Greeter { // Sends a greeting rpc SayHello (HelloRequest) returns (HelloReply) {} } // The request message containing the user's name. message HelloRequest { string name = 1 ; } // The response message containing the greetings message HelloReply { string message = 1 ; } |
main.go
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
|
package main import ( "context" "fmt" "grpc-hello/proto" "log" "net" "google.golang.org/grpc" "google.golang.org/grpc/reflection" ) func main() { lis, err := net.Listen( "tcp" , ":50051" ) if err != nil { log.Fatalf( "failed to listen: %v" , err) } server := grpc.NewServer() // 注册 grpcurl 所需的 reflection 服务 reflection.Register(server) // 注册业务服务 proto.RegisterGreeterServer(server, &greeter{}) fmt. Println ( "grpc server start ..." ) if err := server.Serve(lis); err != nil { log.Fatalf( "failed to serve: %v" , err) } } type greeter struct { } func (*greeter) SayHello(ctx context.Context, req *proto.HelloRequest) (*proto.HelloReply, error ) { fmt. Println (req) reply := &proto.HelloReply{Message: "hello" } return reply, nil } |
运行服务:
1
2
|
go run main.go server start ... |
grpcurl 安装
这里我介绍三种方式:
Mac
1
|
brew install grpcurl |
Docker
1
2
3
4
|
# Download image docker pull fullstorydev /grpcurl :latest # Run the tool docker run fullstorydev /grpcurl api.grpc.me:443 list |
go tool
如果有 Go 环境的话,可以通过 go tool 来安装:
1
|
go install github.com/fullstorydev/grpcurl/cmd/grpcurl@latest |
grpcurl 使用
查看服务列表:
1
|
grpcurl -plaintext 127.0.0.1:50051 list |
输出:
grpc.reflection.v1alpha.ServerReflection
proto.Greeter
查看某个服务的方法列表:
1
|
grpcurl -plaintext 127.0 . 0.1 : 50051 list proto.Greeter |
输出:
proto.Greeter.SayHello
查看方法定义:
1
|
grpcurl -plaintext 127.0 . 0.1 : 50051 describe proto.Greeter.SayHello |
输出:
proto.Greeter.SayHello is a method:
rpc SayHello ( .proto.HelloRequest ) returns ( .proto.HelloReply );
查看请求参数:
1
|
grpcurl -plaintext 127.0.0.1:50051 describe proto.HelloRequest |
输出:
proto.HelloRequest is a message:
message HelloRequest {
string name = 1;
}
请求服务:
1
|
grpcurl -d '{"name": "zhangsan"}' -plaintext 127.0 . 0.1 : 50051 proto.Greeter.SayHello |
输出:
{
"message": "hello"
}
可能遇到的错误
可能会遇到两个报错:
1、gRPC Server 未启用 TLS:
报错信息:
1
|
Failed to dial target host "127.0.0.1:50051": tls: first record does not look like a TLS handshake |
解决:
请求时增加参数:-plaintext
,参考上面的命令。
2、参数格式错误:
报错信息:
1
|
Error invoking method "greet.Greeter/SayHello": error getting request data: invalid character 'n' looking for beginning of object key string |
解决:
-d
后面参数为 json 格式,并且需要使用 ''
包裹起来。
总结
用这个工具做一些简单的测试还是相当方便的,上手也简单。只要掌握文中提到的几条命令,基本可以涵盖大部分的测试需求了
扩展阅读:
https://appimage.github.io/BloomRPC/
https://github.com/fullstorydev/grpcurl
源码下载地址:https://github.com/yongxinz/gopher/tree/main/blog
以上就是grpcurl通过命令行访问gRPC服务的详细内容,更多关于grpcurl命令行访问gRPC服务的资料请关注服务器之家其它相关文章!
原文链接:https://mp.weixin.qq.com/s/GShwcGCopXVmxCKnYf5FhA