首页 > Golang > Go教程

GolanggRPC客户端服务端实战教程

时间：2025-10-05 13:41:33 493浏览收藏

来到golang学习网的大家，相信都是编程学习爱好者，希望在这里学习Golang相关编程知识。下面本篇文章就来带大家聊聊《Golang gRPC客户端与服务端示例解析》，介绍一下，希望对大家的知识积累有所帮助，助力实战开发！

gRPC基于Protocol Buffers和HTTP/2实现高效通信，Golang支持完善。1. 定义proto文件描述服务接口；2. 用protoc生成Go代码；3. 服务端实现SayHello并启动监听；4. 客户端连接并调用方法；5. 先启服务端再运行客户端，输出“Response: Hello, Alice”。

Golang gRPC客户端请求与服务端处理示例

gRPC 是一种高性能、开源的远程过程调用（RPC）框架，基于 Protocol Buffers 和 HTTP/2。Golang 对 gRPC 的支持非常完善，适合构建微服务之间的通信。下面通过一个简单的示例，展示 Golang 中 gRPC 客户端如何发起请求，以及服务端如何处理。

1. 定义 Proto 文件

首先定义一个 .proto 文件，描述服务接口和消息格式。

// hello.proto
syntax = "proto3";

package greet;

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

message HelloRequest {
string name = 1;
}

message HelloReply {
string message = 1;
}

使用 protoc 工具生成 Go 代码：

protoc --go_out=. --go_opt=paths=source_relative \
--go-grpc_out=. --go-grpc_opt=paths=source_relative \
hello.proto

2. 实现 gRPC 服务端

服务端实现 SayHello 方法，并启动 gRPC 服务器监听请求。

package main

import (
"context"
"log"
"net"

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

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")
if err := s.Serve(lis); err != nil {
log.Fatalf("failed to serve: %v", err)
}
}

3. 实现 gRPC 客户端

客户端连接到服务端并调用 SayHello 方法。

package main

import (
"context"
"log"

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

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)
}

4. 运行步骤

先运行服务端：go run server.go
再运行客户端：go run client.go
输出结果：Response: Hello, Alice

这个例子展示了最基本的 gRPC 请求-响应模式。实际项目中可扩展为流式调用、认证、拦截器等高级功能。

基本上就这些，不复杂但容易忽略细节，比如 proto 路径、模块导入和生成命令的参数。

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