2. gRPC入门：Protocol Buffers（protobuf）语法、gRPC服务定义、protoc编译器的安装与使用

gRPC 是 Google 开源的高性能远程过程调用（RPC）框架，其底层序列化协议采用 Protocol Buffers（protobuf）。理解 protobuf 语法、服务定义方式以及 protoc 编译器的使用，是构建 gRPC 压测闭环的第一步。

2.1 Protocol Buffers 核心语法

Protocol Buffers 是一种语言无关、平台无关的序列化结构数据格式，比 JSON/XML 更小、更快。其核心文件以 .proto 为后缀，通过定义消息（message）和服务（service）来描述数据结构与 RPC 接口。

2.1.1 消息定义基础

每个 .proto 文件以 syntax 声明开始，指定 protobuf 版本（推荐 proto3）。消息由字段组成，每个字段包含：类型、名称、唯一编号。

syntax = "proto3";

package helloworld;

// 请求消息
message HelloRequest {
  string name = 1;
  int32 age = 2;
  repeated string tags = 3;
}

// 响应消息
message HelloReply {
  string message = 1;
  int32 code = 2;
}

2.1.2 标量类型与默认值

proto3 中所有字段都有默认值，发送方不传输默认值字段，进一步压缩数据体积。

2.2 gRPC 服务定义

在 .proto 文件中使用 service 关键字定义 RPC 服务，每个 RPC 方法指定输入消息和输出消息。gRPC 支持四种服务模式。

service Greeter {
  // 一元 RPC：客户端发送一个请求，服务端返回一个响应
  rpc SayHello (HelloRequest) returns (HelloReply);

  // 服务端流式 RPC：客户端发送一个请求，服务端返回流式响应
  rpc SayHelloServerStream (HelloRequest) returns (stream HelloReply);

  // 客户端流式 RPC：客户端发送流式请求，服务端返回一个响应
  rpc SayHelloClientStream (stream HelloRequest) returns (HelloReply);

  // 双向流式 RPC：双方使用读写流交互
  rpc SayHelloBidiStream (stream HelloRequest) returns (stream HelloReply);
}

2.3 protoc 编译器安装与使用

protoc 是 protobuf 的编译器，将 .proto 文件编译成目标语言的代码。对于 Go 语言，还需要安装 protoc-gen-go 和 protoc-gen-go-grpc 插件。

2.3.1 安装步骤

1. 下载 protoc：从 GitHub Releases 下载对应操作系统的压缩包，解压后将 bin/protoc 加入 PATH。
2. 安装 Go 插件：

go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest

3. 验证安装：

protoc --version          # 输出 libprotoc 3.x.x
protoc-gen-go --version   # 输出版本号
protoc-gen-go-grpc --version

2.3.2 编译命令

将 .proto 文件编译为 Go 代码，生成两个文件：*.pb.go（消息结构体）和 *_grpc.pb.go（gRPC 客户端/服务端接口）。

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

2.4 protobuf 编译与 gRPC 代码生成流程

下图展示了从 .proto 文件到 Go 代码的完整编译链路，以及 gRPC 服务在压测闭环中的位置。

2.5 常见错误与避坑指南

• protoc 版本不匹配：protoc 版本与 protoc-gen-go 插件版本不兼容会导致生成代码编译失败。建议统一使用最新稳定版。
• import 路径错误：当 .proto 文件跨包引用时，必须使用 --proto_path 指定根目录，否则编译报错。
• Go module 路径冲突：生成的 .pb.go 文件中的 package 声明必须与 Go module 路径一致，否则 import 时找不到包。
• 字段编号重复：同一消息内字段编号必须唯一，重复编号会导致序列化/反序列化数据错乱。