技能介绍

解决服务间通信的契约模糊与演进难题

在微服务架构中，随着服务数量的增加，接口定义往往变得随意且缺乏约束。请求与响应结构复用不当、字段编号随意变更、流式与一元调用模式混用，导致服务端与客户端版本升级时频繁出现兼容性问题，排查成本极高。gRPC 服务设计技能旨在通过严谨的 Protobuf 契约管理与拦截器设计，消除接口歧义，让服务间通信更加高效且可控。

核心能力与关键设计步骤

该技能扮演 gRPC 微服务架构师的角色，按照标准化的五步工作流指导开发：

适用性评估：在引入前先判断场景，强类型契约、双向流式需求或网络效率优先时选择 gRPC；若是简单 CRUD 或浏览器直连则建议转向 REST 或 gRPC-Web。
.proto 文件设计：强调 message 独立命名以支持独立演化，合理规划字段编号（1-15 优先分配给高频字段），正确使用 reserved 关键字防止编号和名称被复用，并规范 enum 零值与 oneof 互斥字段。
流式模式选择：根据业务特征选择 Unary、Server Streaming、Client Streaming 或 Bidirectional，并处理 context 取消与 CloseSend 等底层细节。
拦截器链设计：通过 Unary 与 Stream Interceptor 组合实现日志、鉴权、限流和重试，确保中间件职责单一且通过 chaining 合理排序。
版本兼容策略：制定明确的向前/向后兼容规则，废弃字段需经过 deprecated 标记到 reserved 的完整生命周期。

适用边界与工程注意点

需要注意的是，该技能聚焦于接口设计与架构指导，不直接生成完整的业务逻辑代码。对于浏览器端直接调用或需要向外部第三方开放的公开 API，gRPC 并非首选，建议采用 REST + OpenAPI 方案。此外，在使用 google.protobuf.Struct 处理动态 JSON 时会失去 Protobuf 的类型安全优势，应谨慎评估。