2. gRPC 基础入门

本章是 gRPC 网关接入与微服务链路调优的基石。我们将从 gRPC 的定义出发，深入理解其核心序列化协议 Protocol Buffers，并通过与 RESTful API 的对比明确其适用场景，最后逐一剖析 gRPC 的四种通信模式。掌握这些基础概念，是后续配置网关、优化链路的前提。

2.1 gRPC 定义

gRPC 是一个由 Google 开发的高性能、开源、通用的远程过程调用（RPC）框架。它基于 HTTP/2 协议传输，使用 Protocol Buffers 作为接口定义语言（IDL）和序列化工具。gRPC 的核心思想是：定义一个服务，指定其可以被远程调用的方法及其参数和返回类型，服务端实现该接口并运行一个 gRPC 服务器来处理客户端调用，客户端则拥有一个存根（Stub），像调用本地对象一样直接调用远程服务。

2.2 Protocol Buffers 协议

Protocol Buffers（简称 Protobuf）是 gRPC 的官方接口定义语言（IDL）与数据序列化协议。它使用 .proto 文件定义数据结构和服务接口，然后通过编译器（protoc）生成目标语言的代码。

2.2.1 定义消息与服务

以下是一个典型的 .proto 文件示例，定义了一个简单的用户查询服务：

syntax = "proto3";

package user.v1;

// 请求消息
message GetUserRequest {
    int32 user_id = 1;
}

// 响应消息
message GetUserResponse {
    int32 user_id = 1;
    string name = 2;
    string email = 3;
}

// 定义服务
service UserService {
    rpc GetUser (GetUserRequest) returns (GetUserResponse);
}

2.2.2 Protobuf 与 JSON 序列化对比

2.3 gRPC 与 RESTful API 对比

RESTful API 长期以来是微服务通信的主流选择，但 gRPC 在特定场景下具有显著优势。下表从多个关键维度进行对比：

2.4 gRPC 通信模式

gRPC 基于 HTTP/2 的流式特性，定义了四种通信模式。理解这些模式是设计微服务接口的关键。

2.4.1 四种模式详解

2.4.2 代码示例：Unary 模式

以下是一个简单的 Unary 模式 gRPC 调用示例（Go 语言）：

// 客户端代码
conn, _ := grpc.Dial("localhost:50051", grpc.WithInsecure())
defer conn.Close()

client := pb.NewUserServiceClient(conn)
req := &pb.GetUserRequest{UserId: 123}

// 发起 Unary 调用
resp, err := client.GetUser(context.Background(), req)
if err != nil {
    log.Fatalf("调用失败: %v", err)
}
log.Printf("用户信息: %+v", resp)

// 服务端代码
type userServer struct {
    pb.UnimplementedUserServiceServer
}

func (s *userServer) GetUser(ctx context.Context, req *pb.GetUserRequest) (*pb.GetUserResponse, error) {
    // 模拟数据库查询
    return &pb.GetUserResponse{
        UserId: req.UserId,
        Name:   "张三",
        Email:  "zhangsan@example.com",
    }, nil
}