gRPCGo gRPC契约安全审计与基线治理 - 第1节

1.1 gRPC 简介

gRPC 是由 Google 开源的高性能、跨语言的远程过程调用（RPC）框架，基于 HTTP/2 协议传输，默认使用 Protocol Buffers（protobuf）作为接口定义语言（IDL）和序列化工具。在微服务架构、云原生生态（如 Kubernetes、Istio）中，gRPC 已成为服务间通信的核心组件。

gRPC 的契约审计基线正是围绕 .proto 文件展开：审计人员需要检查服务定义、消息字段、命名规范、向后兼容性、安全配置等，确保接口契约的健壮性与安全性。

1.2 gRPC 与 REST 对比

在微服务接口设计中，REST 与 gRPC 是两种主流风格。理解它们的差异有助于在审计中判断契约设计的合理性。

1.3 gRPC 通信模式

gRPC 支持四种通信模式，每种模式在契约审计中有不同的关注点：

1. Unary RPC（一元模式）：客户端发送单个请求，服务端返回单个响应。与 REST 最相似，适合查询、写入等简单操作。
2. Server Streaming RPC（服务端流模式）：客户端发送单个请求，服务端返回一个消息流。适合日志推送、事件订阅、大数据集分批返回。
3. Client Streaming RPC（客户端流模式）：客户端发送一个消息流，服务端返回单个响应。适合文件上传、批量数据提交、实时数据采集。
4. Bidirectional Streaming RPC（双向流模式）：双方独立发送消息流，顺序由应用层保证。适合聊天、实时协同、游戏状态同步。

1.4 Protocol Buffers 基础

Protocol Buffers（protobuf）是 gRPC 的接口定义语言与序列化引擎。一个典型的 .proto 文件包含：

• 语法声明：syntax = "proto3"; 或 proto2。
• 包名：package mypackage; 用于避免命名冲突。
• 导入：import "google/protobuf/timestamp.proto"; 复用已有类型。
• 消息定义：使用 message 关键字定义结构化数据，每个字段有类型、名称、唯一编号。
• 服务定义：使用 service 关键字定义 RPC 方法，指定输入输出消息。

以下是一个完整的 .proto 示例：

syntax = "proto3";

package audit.v1;

import "google/protobuf/timestamp.proto";

// 用户信息消息
message User {
  uint64 id = 1;               // 用户ID
  string name = 2;             // 用户名
  string email = 3;            // 邮箱
  google.protobuf.Timestamp created_at = 4; // 创建时间
  reserved 5, 6;               // 已废弃字段
}

// 用户服务定义
service UserService {
  // 一元 RPC：获取用户
  rpc GetUser (GetUserRequest) returns (User);

  // 服务端流 RPC：批量获取用户
  rpc ListUsers (ListUsersRequest) returns (stream User);
}

message GetUserRequest {
  uint64 user_id = 1;
}

message ListUsersRequest {
  uint32 page_size = 1;
  uint32 page_number = 2;
}