罗罗编程学习记录
本页内容 展开查看

12.2.1.2 API 协议演进

所属:全栈开发面试题库 / 12 待归类与新技术观察 / 12.2 新框架与新协议 / 12.2.1 新框架与新协议

观察口径:截至 2026 年,各协议生态与工具链成熟度以官方/标准文档为准;本页做机制与场景横比,不固化性能数字。

12.2.1.2-001 API 协议横比看哪些维度?

一句话结论

对比:传输层(HTTP/1.1、HTTP/2、HTTP/3、TCP、WebSocket)、序列化格式、类型契约、通信模式(请求-响应/流式/推送)、浏览器与网关兼容、生态工具;按场景选协议。

概念解释

  • 传输:底层连接与多路复用。
  • 序列化:数据编码格式。
  • 模式:同步/流式/推送。

原理流程

  1. 明确通信模式与场景。
  2. 核对兼容与工具链。
  3. 按约束选协议。

代码 / 图示

通信模式 → 传输/序列化/契约 → 兼容/工具链 → 协议选择

常见误区

  • 误区:协议越新越好;正解:兼容与生态常是硬约束。
  • 误区:协议决定接口设计全部;正解:契约与错误模型同样关键。

追问

  • Q:内部服务与对外 API 选法不同? A:内部可优先类型契约与效率,对外考虑兼容与通用。
  • Q:流式场景见哪条? A:12.2.1.2-014。

12.2.1.2-002 REST 风格的核心约定是什么?

一句话结论

REST 以资源为中心建模,用 HTTP 方法表达操作,状态通过资源表示流转;它是架构风格而非严格协议,实践中常结合 JSON 与状态码;接口设计需保持资源语义一致。

概念解释

  • 资源:URL 标识对象/集合。
  • 方法:GET/POST/PUT/DELETE 等语义。
  • 表示:JSON 等数据格式。

原理流程

  1. 识别业务资源。
  2. 用 URL 与方法建模操作。
  3. 返回表示与状态码。

代码 / 示例

GET /orders/123;POST /orders;PUT /orders/123;DELETE /orders/123

常见误区

  • 误区:URL 里塞动作动词才算 REST;正解:动作由 HTTP 方法表达。
  • 误区:REST 必须严格无状态;正解:会话鉴权等机制按实际设计。

追问

  • Q:REST 与 RPC 风格区别? A:REST 围绕资源,RPC 围绕方法调用。
  • Q:分页/过滤怎么表达? A:查询参数约定,保持接口一致。

12.2.1.2-003 gRPC 的工作原理是什么?

一句话结论

gRPC 基于 IDL 定义服务与消息,编译生成各语言 Stub,传输走 HTTP/2 多路复用,序列化常用 Protobuf;适合内部服务间高效通信;浏览器直连需网关转换。

概念解释

  • IDL:接口与消息契约定义。
  • Stub:生成的客户端/服务端代码。
  • HTTP/2:多路复用传输。

原理流程

  1. 编写 .proto 服务定义。
  2. 生成各语言代码。
  3. 基于 HTTP/2 调用与流式通信。

代码 / 图示

.proto 契约 → 生成 Stub → HTTP/2 多路复用 + Protobuf 序列化

常见误区

  • 误区:gRPC 可被浏览器直接调用;正解:通常需网关转 HTTP/1.1 或 WebSocket。
  • 误区:Protobuf 可读可调试;正解:二进制需工具解码,排障成本高于 JSON。

追问

  • Q:HTTP/2 多路复用好处? A:单连接并发多流,减少连接数,见 12.2.1.3。
  • Q:四种方法类型? A:一元、服务端流、客户端流、双向流。

12.2.1.2-004 Protobuf 序列化与 IDL 有什么特点?

一句话结论

Protobuf 用 IDL 描述消息结构,字段编号标识字段,二进制紧凑编码;向后兼容靠保留字段编号与可选新增;schema 是契约,变更需遵守兼容规则。

概念解释

  • 字段编号:序列化后的标识。
  • 二进制编码:紧凑、体积小。
  • 兼容规则:不重用编号、可加字段。

原理流程

  1. 定义消息 schema。
  2. 编译生成代码。
  3. 按编号编码/解码。

代码 / 示例

message Order { int64 id = 1; string status = 2; }

常见误区

  • 误区:字段名参与序列化;正解:字段编号才是线上标识。
  • 误区:删除字段编号可复用;正解:应保留编号避免旧数据冲突。

追问

  • Q:与 JSON 对比? A:Protobuf 紧凑高效但不可读;JSON 通用可读。
  • Q:schema 演进规则? A:新增字段可选、保留编号、不改变既有字段语义。

12.2.1.2-005 GraphQL 解决什么问题?

一句话结论

GraphQL 由客户端按需查询字段,服务端按 schema 编排返回,减少过度/不足获取;代价是服务端解析编排复杂度、缓存与性能治理;适合聚合查询与多变前端需求。

概念解释

  • Schema:类型与查询契约。
  • 按需取数:客户端声明字段。
  • 编排:服务端组装数据。

原理流程

  1. 定义类型 schema。
  2. 客户端提交查询。
  3. 服务端解析编排返回。

代码 / 图示

Schema → 查询解析 → 数据源编排 → 按需字段返回

常见误区

  • 误区:GraphQL 替代所有 REST;正解:简单资源接口 REST 更直接。
  • 误区:按需取数无性能风险;正解:深层查询可能放大后端压力,需限流与复杂度治理。

追问

  • Q:N+1 问题? A:关联字段逐次查询,需数据加载层批量优化。
  • Q:缓存怎么做? A:按查询与字段粒度设计,比 URL 缓存复杂。

12.2.1.2-006 tRPC 的定位是什么?

一句话结论

tRPC 方向在同构前后端间提供端到端类型安全,类型从服务端直接推导到客户端,省去 IDL 与代码生成;通常绑定特定语言栈,跨语言/跨端场景受限;成熟度以官方文档为准(待确认)。

概念解释

  • 端到端类型:服务端类型直达客户端。
  • 同构栈:前后端同一语言生态。
  • 免 IDL:共享类型定义。

原理流程

  1. 服务端暴露带类型的过程。
  2. 客户端复用类型推导。
  3. 调用时类型检查贯通。

代码 / 图示

服务端过程类型 → 共享类型 → 客户端类型安全调用(同构栈)

常见误区

  • 误区:tRPC 是跨语言 RPC;正解:典型场景为同语言栈前后端。
  • 误区:类型安全覆盖运行期;正解:跨边界外部数据仍需校验。

追问

  • Q:与 gRPC 区别? A:gRPC 跨语言、IDL + HTTP/2;tRPC 偏同构类型贯通。
  • Q:跨端怎么补? A:仍需标准协议与 schema 契约。

12.2.1.2-007 WebSocket 与 SSE 怎么对比?

一句话结论

WebSocket 全双工长连接,双向推送;SSE 服务端单向推送(HTTP 长连接),实现简单、走 HTTP 语义;按是否需要客户端上行与双向通信选择。

概念解释

  • WebSocket:独立协议,全双工。
  • SSE:Server-Sent Events,服务端→客户端单向。
  • 兼容:SSE 基于 HTTP,WebSocket 有握手升级。

原理流程

  1. 判断通信方向。
  2. 单向推送选 SSE。
  3. 双向交互选 WebSocket。

代码 / 图示

单向推送 → SSE;双向实时 → WebSocket

常见误区

  • 误区:SSE 可双向通信;正解:上行仍需另走 HTTP 请求。
  • 误区:长连接天然适合所有实时场景;正解:连接数与扩展需评估。

追问

  • Q:断线重连? A:两者都需应用层处理重连与会话恢复。
  • Q:代理/网关兼容? A:WebSocket 升级与 SSE 流式需网关支持。

12.2.1.2-008 从轮询到推送的通信演进是怎样的?

一句话结论

演进:短轮询(定时请求)→ 长轮询(挂起等待响应)→ SSE/WebSocket(长连接推送);演进方向是降低延迟与无效请求,代价是连接管理与扩展复杂度。

概念解释

  • 短轮询:固定间隔请求。
  • 长轮询:请求挂起直到有结果。
  • 长连接:服务端主动推送。

原理流程

  1. 按实时性要求选模式。
  2. 评估连接与扩展成本。
  3. 设计断线恢复。

代码 / 图示

短轮询 → 长轮询 → SSE/WebSocket;延迟↓,连接管理复杂度↑

常见误区

  • 误区:推送模式一定省资源;正解:长连接占用连接与内存,需容量规划。
  • 误区:轮询已被淘汰;正解:简单低实时场景轮询仍稳妥。

追问

  • Q:长轮询兼容优势? A:基于 HTTP,中间设备友好。
  • Q:推送扩展难点? A:多实例间会话路由与广播。

12.2.1.2-009 协议选型的决策顺序是什么?

一句话结论

先定通信模式(请求响应/流式/推送)与兼容约束(浏览器、网关、端侧),再看类型契约与序列化需求,最后评估工具链与团队;内部服务与对外 API 分开决策。

概念解释

  • 模式:同步/流式/推送。
  • 兼容:客户端与中间设备。
  • 契约:类型/schema 管理。

原理流程

  1. 定通信模式。
  2. 核对兼容约束。
  3. 选契约与序列化。
  4. 评估工具链。

代码 / 图示

模式 → 兼容 → 契约/序列化 → 工具链/团队

常见误区

  • 误区:先挑流行协议再找场景;正解:场景约束先行。
  • 误区:一套协议覆盖所有接口;正解:内部与对外可分层选择。

追问

  • Q:内部服务优先什么? A:效率、类型契约与链路可观测。
  • Q:对外 API 优先什么? A:通用兼容、版本演进与文档。

12.2.1.2-010 序列化格式横比看什么?

一句话结论

对比:可读性、体积、解析速度、schema 约束、跨语言支持、调试便利;JSON 通用可读,二进制格式紧凑高效;选型按链路带宽、调试需求与生态。

概念解释

  • 可读性:人工可解码。
  • 体积:传输带宽。
  • schema:结构约束与校验。

原理流程

  1. 列格式维度。
  2. 按链路与调试需求取舍。
  3. 核对跨语言支持。

代码 / 图示

JSON(通用可读) / 二进制(紧凑高效) × schema × 调试 × 跨语言

常见误区

  • 误区:体积小就一定快;正解:编解码 CPU 成本也要计入。
  • 误区:二进制格式无需文档;正解:schema/契约仍是必要的。

追问

  • Q:消息体过大先优化什么? A:字段裁剪、压缩与批量合并。
  • Q:格式兼容演进? A:字段可选、保留编号,避免破坏性变更。

12.2.1.2-011 接口版本怎么管理?

一句话结论

版本策略:URL 路径、请求头或语义化兼容演进;优先向后兼容(加字段不加删改),破坏性变更走新版本;版本策略需在对外 API 统一约定并文档化。

概念解释

  • 兼容演进:新增可选字段。
  • 破坏性变更:不兼容需新版本。
  • 版本位置:路径/头/契约。

原理流程

  1. 约定版本标识位置。
  2. 优先兼容扩展。
  3. 破坏性变更发布新版本并维护旧版周期。

代码 / 图示

兼容优先(加可选字段) → 破坏变更 → 新版本 + 旧版退役周期

常见误区

  • 误区:直接改字段语义兼容老客户端;正解:不兼容变更必须隔离版本。
  • 误区:版本号无限叠加;正解:旧版本需有退役计划。

追问

  • Q:向后兼容原则? A:不删字段、不改语义、新增可选。
  • Q:内部接口要不要版本? A:同步发布的内部服务可放宽,跨团队契约仍需兼容约定。

12.2.1.2-012 错误模型与状态码怎么设计?

一句话结论

区分传输/业务错误:HTTP 状态码表达传输与大类,业务错误用结构化错误码与消息;错误响应包含可追踪标识;避免把所有错误都返回 200 或 500。

概念解释

  • 状态码:协议层大类。
  • 业务错误码:应用层细分。
  • 追踪标识:请求关联日志。

原理流程

  1. 映射错误到协议状态码。
  2. 业务错误结构化编码。
  3. 附请求标识便于排查。

代码 / 示例

{ "code": "ORDER_NOT_FOUND", "message": "...", "traceId": "..." }

常见误区

  • 误区:业务失败也返回 200;正解:状态码与业务码分层表达。
  • 误区:错误消息暴露内部细节;正解:对外消息脱敏,详情走追踪标识。

追问

  • Q:幂等与错误重试? A:错误码需区分可重试与不可重试。
  • Q:gRPC 错误模型? A:状态码 + 详情,映射到 HTTP 由网关处理。

12.2.1.2-013 鉴权在协议层怎么放置?

一句话结论

鉴权信息经请求头/令牌承载,与业务报文分离;协议本身不内置业务鉴权;选型时核对令牌传递、刷新机制与网关校验位置。

概念解释

  • 令牌:身份凭证。
  • 传递位置:请求头为主。
  • 校验位置:网关/服务内。

原理流程

  1. 客户端获取令牌。
  2. 请求携带令牌头。
  3. 网关/服务校验后放行。

代码 / 图示

令牌 → 请求头携带 → 网关/服务校验 → 业务处理

常见误区

  • 误区:把凭证放 URL 参数;正解:参数易被日志/代理记录,放请求头。
  • 误区:协议选型决定鉴权方案;正解:鉴权是独立横切层。

追问

  • Q:跨服务鉴权传递? A:令牌交换/服务间凭证,按安全设计。
  • Q:详见哪个分册? A:认证授权主题见 06 分册对应章节。

12.2.1.2-014 流式通信适用哪些场景?

一句话结论

流式场景:服务端进度推送、大消息分片、实时行情/日志流、双向协作;协议可选 gRPC 流、SSE、WebSocket;需处理背压、断线恢复与消息顺序。

概念解释

  • 流:持续消息序列。
  • 背压:消费慢时的流量控制。
  • 顺序/恢复:消息次序与断线续传。

原理流程

  1. 判断是否持续消息序列。
  2. 选流式协议。
  3. 设计背压、顺序与恢复。

代码 / 图示

持续消息 → 流协议 → 背压/顺序/断线恢复

常见误区

  • 误区:流式就是大请求分多次;正解:流强调持续会话与增量消息。
  • 误区:忽略背压;正解:消费方慢会积压内存。

追问

  • Q:背压怎么实现? A:协议/应用层流控,按消费节奏发送。
  • Q:断线恢复? A:消息序号/游标,重连后续传。

12.2.1.2-015 网关在协议转换中扮演什么角色?

一句话结论

网关可做对外协议与内部协议的转换(如外部 HTTP/JSON ↔ 内部 gRPC)、鉴权、限流与路由;转换层需关注性能损耗、错误映射与契约维护。

概念解释

  • 协议转换:边界处编码/格式转换。
  • 横切能力:鉴权/限流/路由。
  • 维护成本:两套契约映射。

原理流程

  1. 外部请求进入网关。
  2. 鉴权限流后转换协议。
  3. 调用内部服务并回包转换。

代码 / 图示

外部 HTTP/JSON → 网关(鉴权/限流/转换) → 内部 gRPC;回程反向转换

常见误区

  • 误区:网关转换无开销;正解:编组与网络跳转增加延迟。
  • 误区:错误可直接透传;正解:对外错误模型需重新映射。

追问

  • Q:BFF 层定位? A:按端侧聚合接口,与网关职责区分。
  • Q:协议转换风险? A:契约不同步导致映射错误。

12.2.1.2-016 浏览器与端侧兼容约束怎么核对?

一句话结论

核对目标客户端(浏览器版本、App 系统版本、小程序/端侧)对协议与格式的支持;gRPC 直连受限,需降级方案;选型前列出客户端兼容清单。

概念解释

  • 客户端矩阵:浏览器/系统版本。
  • 协议支持:原生/降级路径。
  • 降级:备选协议方案。

原理流程

  1. 列客户端版本矩阵。
  2. 核对协议/格式支持。
  3. 不满足处设计降级。

代码 / 图示

客户端矩阵 → 协议支持核对 → 不满足 → 降级方案

常见误区

  • 误区:服务端支持即可;正解:客户端能力才是约束。
  • 误区:老客户端无需兼容;正解:按业务存量评估。

追问

  • Q:gRPC 浏览器方案? A:网关转 HTTP/WebSocket 或 gRPC-Web,以生态为准(待确认)。
  • Q:端侧协议选型见哪章? A:07 端侧分册后续章节。

12.2.1.2-017 协议/接口向后兼容怎么保障?

一句话结论

契约变更遵守兼容规则:新增字段可选、不删除/不改语义、字段编号保留;变更走契约测试与版本检查;跨团队接口以契约为准同步。

概念解释

  • 兼容规则:增删改约束。
  • 契约测试:验证双方兼容。
  • 变更评审:破坏性变更隔离。

原理流程

  1. 评审变更兼容性。
  2. 契约测试覆盖。
  3. 不兼容走新版本。

代码 / 图示

变更评审 → 兼容规则校验 → 契约测试 → 不兼容升版本

常见误区

  • 误区:内部接口随便改;正解:跨服务依赖方未同步会破坏调用。
  • 误区:加字段一定兼容;正解:必填新字段对老客户端不兼容。

追问

  • Q:契约测试做什么? A:校验双方消息结构与行为符合约定。
  • Q:废弃字段怎么处理? A:标记废弃、保留兼容周期后再下线。

12.2.1.2-018 本页哪些协议生态属于待确认?

一句话结论

待确认:各协议最新工具链、浏览器/端侧支持矩阵、gRPC-Web 与 tRPC 成熟度、网关转换方案;机制描述稳定,具体支持情况采用前查官方与客户端文档。

概念解释

  • 工具链:SDK 与代码生成。
  • 支持矩阵:客户端版本。
  • 成熟度:生产案例。

原理流程

  1. 标记随版本变化项。
  2. 列官方/标准文档入口。
  3. 采用前复核。

代码 / 图示

SDK / 支持矩阵 / 成熟度 → 官方文档 + 客户端兼容核实

常见误区

  • 误区:标准发布即全生态支持;正解:落地支持有滞后。
  • 误区:教程说法等同客户端现状;正解:以目标客户端实测为准。

追问

  • Q:面试怎么答协议题? A:讲机制、场景与权衡,兼容细节标注以文档为准。
  • Q:下次更新看什么? A:标准演进、客户端支持与生产案例。