
一般情况下测试 gRPC 服务,使用都是过命通过客户端来直接请求服务端。如果客户端还没准备好的令行话,也可以使用 BloomRPC 这样的访问服务 GUI 客户端。 如果环境不支持安装这种 GUI 客户端的使用话,那么有没有一种工具,过命类似于 curl 这样的令行,直接通过终端,访问服务在命令行发起请求呢?使用 答案肯定是有的,就是高防服务器过命本文要介绍的 grpcurl。 gRPC Server首先来写一个简单的令行 gRPC Server: syntax = "proto3"; package proto; // The greeting service definition. service Greeter { // Sends a greeting rpc SayHello (HelloRequest) returns (HelloReply) {} } // The request message containing the users name. message HelloRequest { string name = 1; } // The response message containing the greetings message HelloReply { string message = 1; } main.go 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 } 运行服务: go run main.go server start ... grpcurl 安装这里我介绍三种方式: Mac brew install grpcurl Docker# Download image docker pull fullstorydev/grpcurl:latest # Run the tool docker run fullstorydev/grpcurl api.grpc.me:443 list go tool如果有 Go 环境的话,可以通过 go tool 来安装: go install github.com/fullstorydev/grpcurl/cmd/grpcurl@latest grpcurl 使用查看服务列表: grpcurl -plaintext 127.0.0.1:50051 list 输出: grpc.reflection.v1alpha.ServerReflection proto.Greeter 查看某个服务的访问服务方法列表: grpcurl -plaintext 127.0.0.1:50051 list proto.Greeter 输出: proto.Greeter.SayHello 查看方法定义: grpcurl -plaintext 127.0.0.1:50051 describe proto.Greeter.SayHello 输出: proto.Greeter.SayHello is a method: rpc SayHello ( .proto.HelloRequest ) returns ( .proto.HelloReply ); 查看请求参数: grpcurl -plaintext 127.0.0.1:50051 describe proto.HelloRequest 输出: proto.HelloRequest is a message: message HelloRequest { string name = 1; } 请求服务: grpcurl -d {"name": "zhangsan"} -plaintext 127.0.0.1:50051 proto.Greeter.SayHello 输出: { "message": "hello" } 可能遇到的错误可能会遇到两个报错: 1、gRPC Server 未启用 TLS: 报错信息: Failed to dial target host "127.0.0.1:50051": tls: first record does not look like a TLS handshake 解决: 请求时增加参数:-plaintext,使用参考上面的过命命令。 2、令行参数格式错误: 报错信息: 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 文章中的脑图和源码都上传到了 GitHub,有需要的同学可自行下载。 地址: https://github.com/yongxinz/gopher/tree/main/blog 本文转载自微信公众号「AlwaysBeta」,可以通过以下二维码关注。转载本文请联系AlwaysBeta公众号。  云南idc服务商 |