0

0

如何使用Golang实现RPC调用_使用gRPC生成客户端与服务端代码

P粉602998670

P粉602998670

发布时间:2025-12-22 19:33:08

|

232人浏览过

|

来源于php中文网

原创

Go实现gRPC调用需四步:1.安装protoc、protoc-gen-go和protoc-gen-go-grpc;2.编写.proto文件并生成.pb.go和_grpc.pb.go;3.服务端实现UnimplementedGreeterServer并注册;4.客户端通过grpc.Dial连接并调用。

如何使用golang实现rpc调用_使用grpc生成客户端与服务端代码

用 Go 实现 gRPC 调用,核心是定义 Protocol Buffer 接口、用 protoc 生成 Go 代码、再分别编写服务端和客户端逻辑。整个过程不复杂但容易忽略细节,比如插件安装、导入路径、TLS 配置等。

1. 安装必要工具

要生成 Go 代码,需提前装好:

  • Protocol Buffers 编译器(protoc):从 GitHub releases 下载对应系统的二进制,加入 $PATH
  • Go 的 protoc 插件:protoc-gen-go
    go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
  • gRPC 插件:protoc-gen-go-grpc
    go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest

确认安装成功:运行 protoc --versionprotoc-gen-go --version(部分版本可能无响应,只要不报错且能生成代码即可)。

2. 编写 .proto 文件并生成 Go 代码

在项目根目录创建 api/hello.proto

立即学习go语言免费学习笔记(深入)”;

syntax = "proto3";

package api;

option go_package = "./api;api";

service Greeter {
  rpc SayHello (HelloRequest) returns (HelloReply) {}
}

message HelloRequest {
  string name = 1;
}

message HelloReply {
  string message = 1;
}

执行命令生成代码(注意当前目录和输出路径):

protoc --go_out=. --go-grpc_out=. --go-grpc_opt=paths=source_relative api/hello.proto

会生成两个文件:api/hello.pb.go(数据结构 + 序列化)和 api/hello_grpc.pb.go(客户端接口 + 服务端抽象)。

iWebMall多用户商城系统
iWebMall多用户商城系统

iWebMall 是一款高性能高扩展能力的开源 LAMP 电子商务软件,定位为大中型电子商务平台软件,服务于有建立电子商务需求的商业客户。这些商业客户不必学习任何计算机编程代码知识,只需要使用 iWebMall 软件他们就可以轻松建立一个功能强大的网上商城,实现用户注册、产品展示、在线定购、在线支付等电子商务功能;iWebMall 集成了产品发布与查询、会员注册登录、购物车、在线订单、在线支付、在

下载

3. 实现 gRPC 服务端

新建 server/main.go

package main

import (
	"context"
	"log"
	"net"

	pb "your-module-name/api" // 替换为你的模块路径
	"google.golang.org/grpc"
)

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.Fatal(err)
	}
	defer lis.Close()

	grpcServer := grpc.NewServer()
	pb.RegisterGreeterServer(grpcServer, &server{})

	log.Println("gRPC server listening on :50051")
	if err := grpcServer.Serve(lis); err != nil {
		log.Fatal(err)
	}
}

关键点:

  • 实现接口时嵌入 UnimplementedXXXServer,避免未来新增方法导致编译失败
  • RegisterGreeterServer 是生成代码里提供的注册函数,不能手写
  • 默认不启用 TLS;如需加密,用 grpc.Creds(credentials.NewServerTLSFromCert(...))

4. 实现 gRPC 客户端

新建 client/main.go

package main

import (
	"context"
	"log"
	"time"

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

func main() {
	// 连接服务端(禁用 TLS 时用 insecure)
	conn, err := grpc.Dial("localhost:50051", grpc.WithTransportCredentials(insecure.NewCredentials()))
	if err != nil {
		log.Fatal(err)
	}
	defer conn.Close()

	client := pb.NewGreeterClient(conn)

	ctx, cancel := context.WithTimeout(context.Background(), time.Second)
	defer cancel()

	rsp, err := client.SayHello(ctx, &pb.HelloRequest{Name: "World"})
	if err != nil {
		log.Fatal(err)
	}

	log.Printf("Reply: %s", rsp.Message)
}

注意:

  • grpc.Dial 默认不阻塞,加 grpc.WithBlock() 可等待连接就绪(开发调试可用,生产慎用)
  • 使用 insecure.NewCredentials() 表示跳过 TLS 校验;正式环境应配置证书
  • 每次调用建议带 context 控制超时和取消,避免永久阻塞

基本上就这些。跑起来只需 go run server/main.go 和另一个终端 go run client/main.go。后续可扩展中间件(拦截器)、流式 RPC、认证鉴权等。

相关专题

更多
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、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

339

2024.02.23

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

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

209

2024.03.05

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

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

391

2024.05.21

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

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

196

2025.06.09

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

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

191

2025.06.10

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

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

192

2025.06.17

高德地图升级方法汇总
高德地图升级方法汇总

本专题整合了高德地图升级相关教程,阅读专题下面的文章了解更多详细内容。

72

2026.01.16

热门下载

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

精品课程

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

共21课时 | 2.8万人学习

Git版本控制工具
Git版本控制工具

共8课时 | 1.5万人学习

Git中文开发手册
Git中文开发手册

共0课时 | 0人学习

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

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