形态
| 形态 | 语义 | 典型场景 |
|---|---|---|
| 一元 | 请求-响应 | 常规查询与命令 |
| 服务端流 | 一次请求多次响应 | 订阅推送、大结果集 |
| 客户端流 | 多次请求一次响应 | 批量上报、上传 |
| 双向流 | 双方持续互发 | 实时协作、会话 |
浏览器直连需要 gRPC-Web 与代理支持；对外公开 API 与内网 RPC 的选型可以不同。
gRPC
基于 HTTP/2 与 Protocol Buffers 的 RPC 框架，支持四种调用形态（一元、服务端流、客户端流、双向流）与跨语言代码生成，适合内网服务间高吞吐调用。
易错点
- 用 gRPC 直连浏览器，未部署 gRPC-Web 转换层
- 流式接口未设超时与流控，连接长期挂起耗尽资源
数据来源与参考
- gRPC 官方文档（grpc.io）
- Google API 设计指南：gRPC 章节