3. gRPC 基础与 Protocol Buffers

在微服务架构中，服务间通信的效率与契约的严谨性直接决定了系统的整体质量。gRPC 作为高性能的远程过程调用框架，配合 Protocol Buffers（Protobuf）作为接口定义语言，已成为云原生生态中服务间通信的事实标准。本节将系统介绍 gRPC 的核心机制、Protobuf 的语法体系，并通过与 JSON/XML 的对比，揭示其性能优势的底层原理。

3.1 gRPC 简介

gRPC 是由 Google 开源的高性能、跨语言的 RPC 框架，基于 HTTP/2 协议传输，默认使用 Protocol Buffers 作为序列化与接口定义工具。其核心设计理念是“定义一次，随处调用”，通过 .proto 文件统一描述服务接口与消息结构，自动生成多种语言的客户端与服务端代码。

3.2 Protocol Buffers 语法详解

Protocol Buffers 是一种语言中立、平台中立的可扩展序列化结构数据格式。其核心文件以 .proto 为扩展名，通过 protoc 编译器生成目标语言的代码。以下从 message 和 service 两个核心概念展开。

3.2.1 message 定义

message 用于定义数据结构，类似于 JSON 中的对象或 XML 中的元素。每个字段由“类型 字段名 = 编号;”组成，编号用于二进制编码标识，1~15 占用 1 字节，16~2047 占用 2 字节。

syntax = "proto3";  // 指定语法版本

package ecommerce;

// 定义订单消息
message Order {
  string order_id = 1;          // 订单ID
  int32 user_id = 2;            // 用户ID
  repeated string items = 3;    // 商品列表（repeated 表示数组）
  double total_amount = 4;      // 总金额
  Status status = 5;            // 枚举类型
  Address shipping_address = 6; // 嵌套消息
  google.protobuf.Timestamp created_at = 7; // 时间戳类型
}

// 枚举定义
enum Status {
  STATUS_UNSPECIFIED = 0;
  PENDING = 1;
  SHIPPED = 2;
  DELIVERED = 3;
}

// 嵌套消息
message Address {
  string street = 1;
  string city = 2;
  string zip_code = 3;
}

3.2.2 service 定义

service 用于定义 RPC 接口，指定方法名、请求消息类型与响应消息类型。gRPC 支持四种调用模式，通过流关键字 stream 区分。

service OrderService {
  // 一元 RPC：客户端发送一个请求，服务端返回一个响应
  rpc CreateOrder(CreateOrderRequest) returns (CreateOrderResponse);

  // 服务端流式 RPC：客户端发送一个请求，服务端返回多个响应
  rpc ListOrders(ListOrdersRequest) returns (stream Order);

  // 客户端流式 RPC：客户端发送多个请求，服务端返回一个响应
  rpc BatchCreateOrder(stream CreateOrderRequest) returns (BatchCreateOrderResponse);

  // 双向流式 RPC：双方独立发送多个消息
  rpc ChatOrderStatus(stream OrderStatusRequest) returns (stream OrderStatusResponse);
}

message CreateOrderRequest {
  Order order = 1;
}

message CreateOrderResponse {
  string order_id = 1;
  bool success = 2;
}

message ListOrdersRequest {
  int32 user_id = 1;
  int32 page_size = 2;
}

message BatchCreateOrderResponse {
  repeated string order_ids = 1;
}

message OrderStatusRequest {
  string order_id = 1;
}

message OrderStatusResponse {
  string order_id = 1;
  Status current_status = 2;
}

3.3 Protobuf 数据类型体系

Protobuf 提供了一套完整的数据类型，覆盖标量、枚举、复合类型与特殊类型。下表列出常用标量类型及其对应各语言映射关系。

3.4 Protobuf 与 JSON/XML 对比优势

在微服务通信中，序列化格式的选择直接影响延迟、带宽和 CPU 开销。以下从多个维度对比 Protobuf、JSON 和 XML。

3.5 本章小结