考察点:内外协议分离、网关转换开销、接口定义单一来源。架构设计题。
要点:
google.api.http 注解(如 option (google.api.http) = { get: "/v1/users/{id}" }),自动生成一个把 REST/JSON 请求转成 gRPC 调用的网关。核心价值:接口定义只有一份(.proto),gRPC 服务、REST 网关、客户端 SDK、文档全部从它生成,避免「REST 一份、gRPC 一份」的契约漂移。1. 多一层转换开销:JSON ↔ Protobuf 的序列化/反序列化、HTTP/1.1 ↔ HTTP/2 的协议转换,吞吐与延迟都劣于直连 gRPC;
2. HTTP 语义映射的坑:gRPC 的状态码是枚举(NOT_FOUND 等),映射到 HTTP 状态码有默认规则但常需自定义(runtime.HTTPError 钩子);字段命名风格(Protobuf snake_case ↔ JSON camelCase)、时间戳格式(Timestamp → RFC3339 字符串)、int64 在 JSON 里必须用字符串(JS 精度问题)——这些都是联调时的高频争议点;
3. 流式支持有限:REST 侧只能映射 Server Streaming(用分块响应/NDJSON),客户端流与双向流无法映射(REST 没有对应语义);
4. 额外组件维护成本:多一个网关要部署、监控、升级;生成的代码要与 .proto 保持同步(应放进 CI,禁止手改生成产物);
5. 调试链路变长:客户端报错时要区分「是网关映射错了、还是 gRPC 服务真的是这个错」——网关必须透传 trace id 并保留原始错误细节(但要脱敏)。
- Connect(Buf 出品):一套协议同时提供 gRPC、gRPC-Web 与 HTTP/JSON 三种形态,浏览器可直连,省掉独立网关——新项目值得评估;
- Envoy / APISIX 的 gRPC-JSON 转码:在已有网关里做转换,不引入新组件;
- BFF 层转换:业务复杂度高、需要聚合裁剪时,手写 BFF 反而更可控(自动生成的 REST 接口常常与前端需求不匹配)。
.proto 作为唯一契约源纳入版本管理与 CI 校验(buf lint/breaking 检查);对外接口的设计要能覆盖前端的批量与聚合需求,否则会出现「前端为了一个页面调 6 个接口」。题目与答案就在本页;收藏、批注和错题重练在应用内