首页 > Golang > Go教程

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

时间：2025-09-29 16:26:27 354浏览收藏

目前golang学习网上已经有很多关于Golang的文章了，自己在初次阅读这些文章中，也见识到了很多学习思路；那么本文《Golang实现gRPC客户端与服务端代码生成》，也希望能帮助到大家，如果阅读完后真的对你学习Golang有帮助，欢迎动动手指，评论留言并分享~

首先定义.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语言支持插件：

下载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绑定代码：

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能高效生成类型安全的通信代码，大幅减少网络层样板代码。注意保持.proto文件与生成代码同步更新。

理论要掌握，实操不能落！以上关于《Golang生成gRPC客户端与服务端代码》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！