1. gRPC 概述：定义、核心特性与适用场景

gRPC 是由 Google 开源的高性能、跨语言的远程过程调用（RPC）框架，基于 HTTP/2 协议传输，使用 Protocol Buffers（protobuf）作为接口定义语言（IDL）和序列化工具。它支持四种通信模式：一元调用、服务端流、客户端流和双向流，是构建微服务间高效数据通道的首选方案。

1.1 核心特性矩阵

1.2 gRPC vs REST：关键对比

1.3 gRPC 通信模式与发布拓扑的映射

1.4 适用场景清单

• 微服务间高频通信：服务发现、配置中心、分布式追踪等内部链路，gRPC 的低延迟特性可降低 P99 延迟 40%~60%。
• 实时数据流处理：日志采集、监控指标推送、事件驱动架构中的流式订阅。
• 多语言异构系统集成：通过 .proto 文件生成各语言桩代码，消除跨语言序列化歧义。
• 后端发布拓扑：灰度发布、蓝绿部署、金丝雀发布中的配置下发、版本状态同步、流量切换指令。
• IoT 与边缘计算：设备端与云端之间的双向流指令下发与数据上报。

1.5 快速上手：一个最小 proto 定义

syntax = "proto3";

package publish;

// 发布拓扑中的版本同步服务
service VersionSync {
  // 一元：查询指定节点的当前版本
  rpc GetVersion(VersionRequest) returns (VersionResponse);

  // 服务端流：订阅版本更新推送
  rpc SubscribeVersion(SubscribeRequest) returns (stream VersionEvent);

  // 客户端流：批量上报节点状态
  rpc ReportStatus(stream StatusMessage) returns (ReportAck);

  // 双向流：实时健康检查与配置同步
  rpc HeartbeatSync(stream Heartbeat) returns (stream ConfigCommand);
}

message VersionRequest {
  string node_id = 1;
}

message VersionResponse {
  string version = 1;
  int64 timestamp = 2;
}

message SubscribeRequest {
  repeated string node_ids = 1;
}

message VersionEvent {
  string node_id = 1;
  string new_version = 2;
  string change_log = 3;
}

message StatusMessage {
  string node_id = 1;
  map<string, string> metrics = 2;
}

message ReportAck {
  int32 received_count = 1;
}

message Heartbeat {
  string node_id = 1;
  int64 seq = 2;
}

message ConfigCommand {
  string action = 1;   // "update" | "rollback" | "restart"
  bytes payload = 2;
}