Golang实现gRPC远程调用方法
时间:2026-05-11 12:22:51 137浏览 收藏
本文手把手带你用Go语言实现gRPC远程调用,从零构建一个高效、标准化的微服务通信示例:通过Protocol Buffers定义清晰的接口(hello.proto),利用protoc工具自动生成类型安全的Go代码,再分别编写简洁的服务端(注册Greeter服务并处理SayHello请求)和客户端(建立连接、发起调用并解析响应),全程基于HTTP/2协议,兼顾性能与可维护性——无论你是刚接触gRPC的新手,还是想快速落地Go微服务通信的开发者,都能轻松上手并掌握核心实践要点。

Go语言通过gRPC实现高效远程调用,主要依赖Protocol Buffers和HTTP/2。整个流程包括定义接口、生成代码、实现服务端与客户端。下面详细介绍如何在Golang中使用gRPC进行远程调用。
定义服务接口(.proto文件)
gRPC使用Protocol Buffers定义服务方法和消息结构。你需要编写一个.proto文件来描述服务。
例如,创建hello.proto:
syntax = "proto3";
package greet;
option go_package = "./greetpb";
message HelloRequest {
string name = 1;
}
message HelloResponse {
string message = 1;
}
service Greeter {
rpc SayHello (HelloRequest) returns (HelloResponse);
}
这个文件定义了一个Greeter服务,包含一个SayHello方法。
生成Go代码
使用protoc编译器和Go插件生成服务代码。
安装工具:
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
生成代码:
protoc --go_out=. --go_opt=paths=source_relative \
--go-grpc_out=. --go-grpc_opt=paths=source_relative \
hello.proto
执行后会生成hello.pb.go和hello_grpc.pb.go两个文件,包含结构体和服务桩代码。
实现gRPC服务端
编写服务端程序,注册并启动gRPC服务器。
package main
import (
"log"
"net"
"google.golang.org/grpc"
pb "your-module/greetpb"
)
type server struct {
pb.UnimplementedGreeterServer
}
func (s *server) SayHello(req *pb.HelloRequest, stream pb.Greeter_SayHelloServer) error {
resp := &pb.HelloResponse{
Message: "Hello, " + req.Name,
}
return stream.Send(resp)
}
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 listening on :50051")
if err := s.Serve(lis); err != nil {
log.Fatalf("failed to serve: %v", err)
}
}
实现gRPC客户端
客户端连接服务端并发起远程调用。
package main
import (
"context"
"log"
"google.golang.org/grpc"
"google.golang.org/grpc/credentials/insecure"
pb "your-module/greetpb"
)
func main() {
conn, err := grpc.Dial("localhost:50051", grpc.WithTransportCredentials(insecure.NewCredentials()))
if err != nil {
log.Fatalf("did not connect: %v", err)
}
defer conn.Close()
client := pb.NewGreeterClient(conn)
req := &pb.HelloRequest{Name: "Alice"}
resp, err := client.SayHello(context.Background(), req)
if err != nil {
log.Fatalf("could not greet: %v", err)
}
log.Printf("Response: %s", resp.Message)
}
基本上就这些。只要定义好proto接口,生成代码,再分别实现服务端处理逻辑和客户端调用,就能完成一次gRPC远程调用。注意确保服务端运行后再启动客户端测试。不复杂但容易忽略细节,比如包路径和protoc参数。
以上就是本文的全部内容了,是否有顺利帮助你解决问题?若是能给你带来学习上的帮助,请大家多多支持golang学习网!更多关于Golang的相关知识,也可关注golang学习网公众号。
相关阅读
更多>
-
505 收藏
-
503 收藏
-
502 收藏
-
502 收藏
-
502 收藏
最新阅读
更多>
-
Golang · Go教程 | 19小时前 | errgroup · Context · Go教程 · 后端工程 · Golang实战 · 并发治理 · golang Go 并发编程 错误处理 context errgroup 后端工程 生产实践 SetLimit197 收藏
-
Golang · Go教程 | 19小时前 | singleflight · 并发编程 · Go教程 · 后端工程 · Golang实战 · 缓存治理 · golang Go 并发控制 缓存击穿 请求合并 后端工程 生产实践 singleflight350 收藏
-
Golang · Go教程 | 20小时前 | 超时控制 · 故障排查 · Go教程 · 后端工程 · Golang实战 · HTTP客户端 · golang Go 性能优化 net/http context Transport 超时 http.Client 生产实践205 收藏
-
Golang · Go教程 | 1天前 | 性能优化 · Go教程 · 后端工程 · Golang实战 · database/sql · 连接池调优 · golang Go 性能优化 连接池 MaxOpenConns database/sql 后端工程 DBStats242 收藏
-
Golang · Go教程 | 1天前 | web安全 · Go教程 · 后端工程 · Golang实战 · net/http · CSRF · golang 安全 Go net/http HTTP服务 csrf Go1.25 CrossOriginProtection183 收藏
-
Golang · Go教程 | 1天前 | 优雅关闭 · Go教程 · 后端工程 · Golang实战 · net/http · 服务治理 · golang shutdown Go net/http HTTP服务 优雅关闭 SIGTERM 生产实践135 收藏
-
Golang · Go教程 | 2天前 | 并发编程 · 数据竞争 · Go教程 · 生产实践 · race detector · golang Go 数据竞争 并发 sync atomic race detector go test -race147 收藏
-
311 收藏
-
324 收藏
-
203 收藏
-
413 收藏
-
144 收藏
课程推荐
更多>
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习