Golang使用gRPC生成客户端与服务器代码-Golang-PHP中文网

Golang使用gRPC生成客户端与服务器代码

P粉602998670

发布： 2025-09-14 12:34:01

原创

217人浏览过

首先定义.proto文件并使用protoc生成代码，接着安装Go插件，通过命令生成hello.pb.go和hello_grpc.pb.go文件，然后实现服务器注册Greeter服务并处理SayHello请求，最后编写客户端调用远程方法并打印响应结果。

golang使用grpc生成客户端与服务器代码

在Go语言中使用gRPC生成客户端与服务器代码，核心步骤是定义

.proto

登录后复制

文件并利用

protoc

登录后复制

编译器和插件生成对应代码。整个过程清晰且自动化程度高。

准备Proto文件

首先需要定义gRPC服务的接口和消息结构。创建一个

hello.proto

登录后复制

文件：

syntax = "proto3";

package hello;
option go_package = "./hellopb";

// 定义服务
service Greeter {
  rpc SayHello (HelloRequest) returns (HelloReply);
}

// 请求消息
message HelloRequest {
  string name = 1;
}

// 响应消息
message HelloReply {
  string message = 1;
}

其中

go_package

登录后复制

指定生成代码的包路径，确保后续导入正确。

安装工具与插件

确保系统已安装

protoc

登录后复制

编译器，并安装Go语言支持插件：

立即学习“go语言免费学习笔记（深入）”；

下载
```
protoc
```
登录后复制
：从 GitHub releases 获取对应平台版本

安装Go插件：

go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest

登录后复制

将
```
$GOPATH/bin
```
登录后复制
加入
```
PATH
```
登录后复制
环境变量，使
```
protoc
```
登录后复制
能找到插件

生成Go代码

执行命令生成gRPC绑定代码：

使用JSON进行网络数据交换传输中文WORD版

本文档主要讲述的是使用JSON进行网络数据交换传输；JSON（JavaScript ObjectNotation）是一种轻量级的数据交换格式，易于阅读和编写，同时也易于机器解析和生成，非常适合于服务器与客户端的交互。JSON采用与编程语言无关的文本格式，但是也使用了类C语言的习惯，这些特性使JSON成为理想的数据交换格式。和 XML 一样，JSON 也是基于纯文本的数据格式。由于 JSON 天生是为 JavaScript 准备的，因此，JSON的数据格式非常简单，您可以用 JSON 传输一个简单的 St

查看详情

protoc --go_out=. --go-grpc_out=. hello.proto

登录后复制

该命令会生成两个文件：

```
hello.pb.go
```
登录后复制
：包含消息类型的Go结构体和序列化方法
```
hello_grpc.pb.go
```
登录后复制
：包含客户端接口和服务端抽象接口

生成的代码中，服务

Greeter

登录后复制

会对应一个接口，包含

SayHello(context.Context, *HelloRequest) (*HelloReply, error)

登录后复制

方法。

实现服务器与客户端

使用生成的代码快速搭建服务端：

package main

import (
  "context"
  "log"
  "net"

  "google.golang.org/grpc"
  "./hellopb"
)

type server struct {
  hellopb.UnimplementedGreeterServer
}

func (s *server) SayHello(ctx context.Context, req *hellopb.HelloRequest) (*hellopb.HelloReply, error) {
  return &hellopb.HelloReply{Message: "Hello " + req.Name}, nil
}

func main() {
  l, err := net.Listen("tcp", ":50051")
  if err != nil {
    log.Fatal(err)
  }
  s := grpc.NewServer()
  hellopb.RegisterGreeterServer(s, &server{})
  s.Serve(l)
}

客户端调用示例：

package main

import (
  "context"
  "log"

  "google.golang.org/grpc"
  "google.golang.org/grpc/credentials/insecure"
  "./hellopb"
)

func main() {
  conn, err := grpc.Dial("localhost:50051", grpc.WithTransportCredentials(insecure.NewCredentials()))
  if err != nil {
    log.Fatal(err)
  }
  defer conn.Close()

  client := hellopb.NewGreeterClient(conn)
  resp, err := client.SayHello(context.Background(), &hellopb.HelloRequest{Name: "World"})
  if err != nil {
    log.Fatal(err)
  }
  log.Println(resp.Message)
}

基本上就这些。只要Proto文件定义清楚，gRPC能高效生成类型安全的通信代码，大幅减少网络层样板代码。注意保持