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

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 服务器监听请求。

Productivity Google Workspace

Access Gmail, Calendar, Drive, Docs, and Sheets via the gws CLI or Python.

下载

立即学习“go语言免费学习笔记（深入）”；

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 路径、模块导入和生成命令的参数。