grpc go

grpc-go

GRPC的GO实施：高性能，开源，一般RPC框架，将移动设备和HTTP/2放在首位。有关更多信息，请参见GO GRPC文档，或直接跳入快速启动。

先决条件

• 去：两个最新主要版本中的任何一个。

安装

只需将以下导入添加到您的代码，然后go [build|run|test]将自动获取必要的依赖项：

 import "google.golang.org/grpc"

注意：如果您想从中国访问grpc-go ，请参见下面的常见问题解答。

了解更多

• GO GRPC文档，其中包括快速启动和API参考以及其他资源
• 该存储库的低级技术文档
• 性能基准
• 例子

常问问题

I/O超时错误

golang.org域可能会被某些国家封锁。 go get通常会在发生这种情况时产生以下错误：

$ go get -u google.golang.org/grpc
package google.golang.org/grpc: unrecognized import path "google.golang.org/grpc" (https fetch: Get https://google.golang.org/grpc?go-get=1: dial tcp 216.239.37.1:443: i/o timeout)

要构建GO代码，有几个选择：

• 设置VPN并访问Google.golang.org。

• 使用GO模块支持：可以使用go mod的replace功能为Golang.org软件包创建别名。在您项目的目录中：

  go mod edit -replace=google.golang.org/grpc=github.com/grpc/grpc-go@latest
  go mod tidy
  go mod vendor
  go build -mod=vendor

  同样，这也需要针对Golang.org上托管的所有传递依赖项进行。有关详细信息，请参阅Golang/GO问题＃28652。

编译错误，未定义：grpc.supportpackageisversion

请使用go get google.golang.org/grpc更新到最新版本的GRPC-GO。

如何打开记录

默认记录器由环境变量控制。这样打开一切：

$ export GRPC_GO_LOG_VERBOSITY_LEVEL=99
$ export GRPC_GO_LOG_SEVERITY_LEVEL=info

RPC失败，错误"code = Unavailable desc = transport is closing"

此错误意味着RPC使用的连接已关闭，并且有许多可能的原因，包括：

1. 不合格的运输证书，握手的连接失败
2. 字节破坏了，可能是由介于两者之间的代理
3. 服务器关闭
4. keepalive参数导致连接关闭，例如，如果您配置了服务器以定期终止连接以触发DNS查找。如果是这种情况，您可能需要增加MaxConnectionGrace，以允许更长的RPC调用完成。

调试此问题可能很棘手，因为错误发生在客户端，但是关闭连接的根本原因在服务器端。打开客户端和服务器上的记录，看看是否有任何传输错误。