0

0

Golang如何使用gRPC生成客户端与服务端代码_Golang gRPC客户端服务端生成实践详解

P粉602998670

P粉602998670

发布时间:2025-11-24 20:24:05

|

462人浏览过

|

来源于php中文网

原创

首先安装protoc编译器及Go插件,然后编写helloworld.proto定义服务接口和消息类型,接着运行protoc命令生成helloworld.pb.go和helloworld_grpc.pb.go两个文件,最后在Go代码中实现服务端GreeterServer接口和客户端调用逻辑,启动服务并通信。

golang如何使用grpc生成客户端与服务端代码_golang grpc客户端服务端生成实践详解

在Go语言中使用gRPC进行服务通信,需要通过Protocol Buffers(简称protobuf)定义接口和服务结构,再利用protoc编译器和插件生成客户端与服务端的Go代码。下面详细介绍从定义proto文件到生成gRPC代码的完整流程。

1. 安装必要的工具和依赖

要生成gRPC代码,必须先安装以下组件:

  • protoc编译器:用于解析.proto文件并生成基础代码。
  • Go插件protoc-gen-goprotoc-gen-go-grpc,分别用于生成Go结构体和gRPC服务代码。

执行以下命令安装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语言免费学习笔记(深入)”;

2. 编写.proto文件定义服务

创建一个helloworld.proto文件,定义简单的问候服务:

syntax = "proto3";

option go_package = "./;pb";

package helloworld;

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

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

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

go_package指定生成代码的包路径和包名,这里设为当前目录,包名为pb

3. 使用protoc生成Go代码

在.proto文件所在目录运行以下命令:

聚蜂消防BeesFPD
聚蜂消防BeesFPD

关注消防领域的智慧云平台

下载
protoc --go_out=. --go_opt=paths=source_relative \
--go-grpc_out=. --go-grpc_opt=paths=source_relative \
helloworld.proto

执行后会生成两个文件:

  • helloworld.pb.go:包含消息类型的Go结构体和序列化方法。
  • helloworld_grpc.pb.go:包含客户端接口和服务端抽象接口。

生成的代码中,服务端需实现GreeterServer接口,客户端可直接调用GreeterClient接口。

4. 实现服务端与客户端逻辑

服务端示例:

package main

import (
"context"
"log"
"net"

"google.golang.org/grpc"
pb "your-module/pb"
)

type server struct {
pb.UnimplementedGreeterServer
}

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

func main() {
lis, err := net.Listen("tcp", ":50051")
if err != nil {
log.Fatalf("failed to listen: %v", err)
}
s := grpc.NewServer()
pb.RegisterGreeterServer(s, &server{})
log.Println("gRPC server running on :50051")
s.Serve(lis)
}

客户端示例:

package main

import (
"context"
"log"

"google.golang.org/grpc"
"google.golang.org/grpc/credentials/insecure"
pb "your-module/pb"
)

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

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

运行服务端后,执行客户端即可看到输出:Hello Alice

基本上就这些。只要定义好proto文件,gRPC能自动生成高效、类型安全的通信代码,极大简化远程调用开发。注意保持proto与生成代码同步,并合理组织模块路径。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

178

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

226

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

337

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

208

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

389

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

195

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

191

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

192

2025.06.17

Golang gRPC 服务开发与Protobuf实战
Golang gRPC 服务开发与Protobuf实战

本专题系统讲解 Golang 在 gRPC 服务开发中的完整实践,涵盖 Protobuf 定义与代码生成、gRPC 服务端与客户端实现、流式 RPC(Unary/Server/Client/Bidirectional)、错误处理、拦截器、中间件以及与 HTTP/REST 的对接方案。通过实际案例,帮助学习者掌握 使用 Go 构建高性能、强类型、可扩展的 RPC 服务体系,适用于微服务与内部系统通信场景。

6

2026.01.15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Go 教程
Go 教程

共32课时 | 3.7万人学习

Go语言实战之 GraphQL
Go语言实战之 GraphQL

共10课时 | 0.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号