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)、序列化格式、类型契约、通信模式(请求-响应/流式/推送)、浏览器与网关兼容、生态工具;按场景选协议。
概念解释
- 传输:底层连接与多路复用。
- 序列化:数据编码格式。
- 模式:同步/流式/推送。
原理流程
- 明确通信模式与场景。
- 核对兼容与工具链。
- 按约束选协议。
代码 / 图示
通信模式 → 传输/序列化/契约 → 兼容/工具链 → 协议选择
常见误区
- 误区:协议越新越好;正解:兼容与生态常是硬约束。
- 误区:协议决定接口设计全部;正解:契约与错误模型同样关键。
追问
- 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 等数据格式。
原理流程
- 识别业务资源。
- 用 URL 与方法建模操作。
- 返回表示与状态码。
代码 / 示例
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:多路复用传输。
原理流程
- 编写 .proto 服务定义。
- 生成各语言代码。
- 基于 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 是契约,变更需遵守兼容规则。
概念解释
- 字段编号:序列化后的标识。
- 二进制编码:紧凑、体积小。
- 兼容规则:不重用编号、可加字段。
原理流程
- 定义消息 schema。
- 编译生成代码。
- 按编号编码/解码。
代码 / 示例
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:类型与查询契约。
- 按需取数:客户端声明字段。
- 编排:服务端组装数据。
原理流程
- 定义类型 schema。
- 客户端提交查询。
- 服务端解析编排返回。
代码 / 图示
Schema → 查询解析 → 数据源编排 → 按需字段返回
常见误区
- 误区:GraphQL 替代所有 REST;正解:简单资源接口 REST 更直接。
- 误区:按需取数无性能风险;正解:深层查询可能放大后端压力,需限流与复杂度治理。
追问
- Q:N+1 问题? A:关联字段逐次查询,需数据加载层批量优化。
- Q:缓存怎么做? A:按查询与字段粒度设计,比 URL 缓存复杂。
12.2.1.2-006 tRPC 的定位是什么?
一句话结论
tRPC 方向在同构前后端间提供端到端类型安全,类型从服务端直接推导到客户端,省去 IDL 与代码生成;通常绑定特定语言栈,跨语言/跨端场景受限;成熟度以官方文档为准(待确认)。
概念解释
- 端到端类型:服务端类型直达客户端。
- 同构栈:前后端同一语言生态。
- 免 IDL:共享类型定义。
原理流程
- 服务端暴露带类型的过程。
- 客户端复用类型推导。
- 调用时类型检查贯通。
代码 / 图示
服务端过程类型 → 共享类型 → 客户端类型安全调用(同构栈)
常见误区
- 误区: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 有握手升级。
原理流程
- 判断通信方向。
- 单向推送选 SSE。
- 双向交互选 WebSocket。
代码 / 图示
单向推送 → SSE;双向实时 → WebSocket
常见误区
- 误区:SSE 可双向通信;正解:上行仍需另走 HTTP 请求。
- 误区:长连接天然适合所有实时场景;正解:连接数与扩展需评估。
追问
- Q:断线重连? A:两者都需应用层处理重连与会话恢复。
- Q:代理/网关兼容? A:WebSocket 升级与 SSE 流式需网关支持。
12.2.1.2-008 从轮询到推送的通信演进是怎样的?
一句话结论
演进:短轮询(定时请求)→ 长轮询(挂起等待响应)→ SSE/WebSocket(长连接推送);演进方向是降低延迟与无效请求,代价是连接管理与扩展复杂度。
概念解释
- 短轮询:固定间隔请求。
- 长轮询:请求挂起直到有结果。
- 长连接:服务端主动推送。
原理流程
- 按实时性要求选模式。
- 评估连接与扩展成本。
- 设计断线恢复。
代码 / 图示
短轮询 → 长轮询 → SSE/WebSocket;延迟↓,连接管理复杂度↑
常见误区
- 误区:推送模式一定省资源;正解:长连接占用连接与内存,需容量规划。
- 误区:轮询已被淘汰;正解:简单低实时场景轮询仍稳妥。
追问
- Q:长轮询兼容优势? A:基于 HTTP,中间设备友好。
- Q:推送扩展难点? A:多实例间会话路由与广播。
12.2.1.2-009 协议选型的决策顺序是什么?
一句话结论
先定通信模式(请求响应/流式/推送)与兼容约束(浏览器、网关、端侧),再看类型契约与序列化需求,最后评估工具链与团队;内部服务与对外 API 分开决策。
概念解释
- 模式:同步/流式/推送。
- 兼容:客户端与中间设备。
- 契约:类型/schema 管理。
原理流程
- 定通信模式。
- 核对兼容约束。
- 选契约与序列化。
- 评估工具链。
代码 / 图示
模式 → 兼容 → 契约/序列化 → 工具链/团队
常见误区
- 误区:先挑流行协议再找场景;正解:场景约束先行。
- 误区:一套协议覆盖所有接口;正解:内部与对外可分层选择。
追问
- Q:内部服务优先什么? A:效率、类型契约与链路可观测。
- Q:对外 API 优先什么? A:通用兼容、版本演进与文档。
12.2.1.2-010 序列化格式横比看什么?
一句话结论
对比:可读性、体积、解析速度、schema 约束、跨语言支持、调试便利;JSON 通用可读,二进制格式紧凑高效;选型按链路带宽、调试需求与生态。
概念解释
- 可读性:人工可解码。
- 体积:传输带宽。
- schema:结构约束与校验。
原理流程
- 列格式维度。
- 按链路与调试需求取舍。
- 核对跨语言支持。
代码 / 图示
JSON(通用可读) / 二进制(紧凑高效) × schema × 调试 × 跨语言
常见误区
- 误区:体积小就一定快;正解:编解码 CPU 成本也要计入。
- 误区:二进制格式无需文档;正解:schema/契约仍是必要的。
追问
- Q:消息体过大先优化什么? A:字段裁剪、压缩与批量合并。
- Q:格式兼容演进? A:字段可选、保留编号,避免破坏性变更。
12.2.1.2-011 接口版本怎么管理?
一句话结论
版本策略:URL 路径、请求头或语义化兼容演进;优先向后兼容(加字段不加删改),破坏性变更走新版本;版本策略需在对外 API 统一约定并文档化。
概念解释
- 兼容演进:新增可选字段。
- 破坏性变更:不兼容需新版本。
- 版本位置:路径/头/契约。
原理流程
- 约定版本标识位置。
- 优先兼容扩展。
- 破坏性变更发布新版本并维护旧版周期。
代码 / 图示
兼容优先(加可选字段) → 破坏变更 → 新版本 + 旧版退役周期
常见误区
- 误区:直接改字段语义兼容老客户端;正解:不兼容变更必须隔离版本。
- 误区:版本号无限叠加;正解:旧版本需有退役计划。
追问
- Q:向后兼容原则? A:不删字段、不改语义、新增可选。
- Q:内部接口要不要版本? A:同步发布的内部服务可放宽,跨团队契约仍需兼容约定。
12.2.1.2-012 错误模型与状态码怎么设计?
一句话结论
区分传输/业务错误:HTTP 状态码表达传输与大类,业务错误用结构化错误码与消息;错误响应包含可追踪标识;避免把所有错误都返回 200 或 500。
概念解释
- 状态码:协议层大类。
- 业务错误码:应用层细分。
- 追踪标识:请求关联日志。
原理流程
- 映射错误到协议状态码。
- 业务错误结构化编码。
- 附请求标识便于排查。
代码 / 示例
{ "code": "ORDER_NOT_FOUND", "message": "...", "traceId": "..." }
常见误区
- 误区:业务失败也返回 200;正解:状态码与业务码分层表达。
- 误区:错误消息暴露内部细节;正解:对外消息脱敏,详情走追踪标识。
追问
- Q:幂等与错误重试? A:错误码需区分可重试与不可重试。
- Q:gRPC 错误模型? A:状态码 + 详情,映射到 HTTP 由网关处理。
12.2.1.2-013 鉴权在协议层怎么放置?
一句话结论
鉴权信息经请求头/令牌承载,与业务报文分离;协议本身不内置业务鉴权;选型时核对令牌传递、刷新机制与网关校验位置。
概念解释
- 令牌:身份凭证。
- 传递位置:请求头为主。
- 校验位置:网关/服务内。
原理流程
- 客户端获取令牌。
- 请求携带令牌头。
- 网关/服务校验后放行。
代码 / 图示
令牌 → 请求头携带 → 网关/服务校验 → 业务处理
常见误区
- 误区:把凭证放 URL 参数;正解:参数易被日志/代理记录,放请求头。
- 误区:协议选型决定鉴权方案;正解:鉴权是独立横切层。
追问
- Q:跨服务鉴权传递? A:令牌交换/服务间凭证,按安全设计。
- Q:详见哪个分册? A:认证授权主题见 06 分册对应章节。
12.2.1.2-014 流式通信适用哪些场景?
一句话结论
流式场景:服务端进度推送、大消息分片、实时行情/日志流、双向协作;协议可选 gRPC 流、SSE、WebSocket;需处理背压、断线恢复与消息顺序。
概念解释
- 流:持续消息序列。
- 背压:消费慢时的流量控制。
- 顺序/恢复:消息次序与断线续传。
原理流程
- 判断是否持续消息序列。
- 选流式协议。
- 设计背压、顺序与恢复。
代码 / 图示
持续消息 → 流协议 → 背压/顺序/断线恢复
常见误区
- 误区:流式就是大请求分多次;正解:流强调持续会话与增量消息。
- 误区:忽略背压;正解:消费方慢会积压内存。
追问
- Q:背压怎么实现? A:协议/应用层流控,按消费节奏发送。
- Q:断线恢复? A:消息序号/游标,重连后续传。
12.2.1.2-015 网关在协议转换中扮演什么角色?
一句话结论
网关可做对外协议与内部协议的转换(如外部 HTTP/JSON ↔ 内部 gRPC)、鉴权、限流与路由;转换层需关注性能损耗、错误映射与契约维护。
概念解释
- 协议转换:边界处编码/格式转换。
- 横切能力:鉴权/限流/路由。
- 维护成本:两套契约映射。
原理流程
- 外部请求进入网关。
- 鉴权限流后转换协议。
- 调用内部服务并回包转换。
代码 / 图示
外部 HTTP/JSON → 网关(鉴权/限流/转换) → 内部 gRPC;回程反向转换
常见误区
- 误区:网关转换无开销;正解:编组与网络跳转增加延迟。
- 误区:错误可直接透传;正解:对外错误模型需重新映射。
追问
- Q:BFF 层定位? A:按端侧聚合接口,与网关职责区分。
- Q:协议转换风险? A:契约不同步导致映射错误。
12.2.1.2-016 浏览器与端侧兼容约束怎么核对?
一句话结论
核对目标客户端(浏览器版本、App 系统版本、小程序/端侧)对协议与格式的支持;gRPC 直连受限,需降级方案;选型前列出客户端兼容清单。
概念解释
- 客户端矩阵:浏览器/系统版本。
- 协议支持:原生/降级路径。
- 降级:备选协议方案。
原理流程
- 列客户端版本矩阵。
- 核对协议/格式支持。
- 不满足处设计降级。
代码 / 图示
客户端矩阵 → 协议支持核对 → 不满足 → 降级方案
常见误区
- 误区:服务端支持即可;正解:客户端能力才是约束。
- 误区:老客户端无需兼容;正解:按业务存量评估。
追问
- Q:gRPC 浏览器方案? A:网关转 HTTP/WebSocket 或 gRPC-Web,以生态为准(待确认)。
- Q:端侧协议选型见哪章? A:07 端侧分册后续章节。
12.2.1.2-017 协议/接口向后兼容怎么保障?
一句话结论
契约变更遵守兼容规则:新增字段可选、不删除/不改语义、字段编号保留;变更走契约测试与版本检查;跨团队接口以契约为准同步。
概念解释
- 兼容规则:增删改约束。
- 契约测试:验证双方兼容。
- 变更评审:破坏性变更隔离。
原理流程
- 评审变更兼容性。
- 契约测试覆盖。
- 不兼容走新版本。
代码 / 图示
变更评审 → 兼容规则校验 → 契约测试 → 不兼容升版本
常见误区
- 误区:内部接口随便改;正解:跨服务依赖方未同步会破坏调用。
- 误区:加字段一定兼容;正解:必填新字段对老客户端不兼容。
追问
- Q:契约测试做什么? A:校验双方消息结构与行为符合约定。
- Q:废弃字段怎么处理? A:标记废弃、保留兼容周期后再下线。
12.2.1.2-018 本页哪些协议生态属于待确认?
一句话结论
待确认:各协议最新工具链、浏览器/端侧支持矩阵、gRPC-Web 与 tRPC 成熟度、网关转换方案;机制描述稳定,具体支持情况采用前查官方与客户端文档。
概念解释
- 工具链:SDK 与代码生成。
- 支持矩阵:客户端版本。
- 成熟度:生产案例。
原理流程
- 标记随版本变化项。
- 列官方/标准文档入口。
- 采用前复核。
代码 / 图示
SDK / 支持矩阵 / 成熟度 → 官方文档 + 客户端兼容核实
常见误区
- 误区:标准发布即全生态支持;正解:落地支持有滞后。
- 误区:教程说法等同客户端现状;正解:以目标客户端实测为准。
追问
- Q:面试怎么答协议题? A:讲机制、场景与权衡,兼容细节标注以文档为准。
- Q:下次更新看什么? A:标准演进、客户端支持与生产案例。