
Hello,我是小兔大白糖。 评审会上有人甩一句:「我们测过了,GraphQL 更快。」——多数时候测的不是协议,而是少返回了字段,或拿「N 次 REST」去撞「1 次 GraphQL」。结论好看,但推不进严肃选型。写成这篇,给要做 GraphQL / REST 性能对照调研 的初中级后端同学:不是某次迁移压测报告,而是业界向、可复述的公平对比心智模型。
说明:文中
FULL/CARD/MIN是教学分档标签,不是某网关或某 BFF 的私有契约。数字阈值(如体积差示意阈值)仅供讨论口径,不是行业标准。示例均为脱敏示意。
估计阅读时间:10 分钟
目录
为什么现在要关心
硬规则三条:同构才谈协议;FULL 对齐才谈「同结果更快」;缓存状态必须成对。
现场里「GraphQL 更快」的好看结论,往往来自三类误伤:
| 你以为在比 | 实际在比 | 推不进评审的原因 |
|---|---|---|
| 协议 / 序列化路径更轻 | 少字段、少嵌套 | 赢的是 trim(裁剪载荷),不是协议 |
| 同业务语义下的延迟 | N 次 REST vs 1 次 GraphQL | 赢的是网络次数,不是同构单请求延迟 |
| 某接口该不该迁 | 未控 token / fixture / 环境 / 缓存 | 单次 p50,不可复现 |
先把两条合法故事拆开写——混写成一句「更快」,评审一定会追问「比的是哪一种」:
| 故事 | 对照方式 | 你能说的话 |
|---|---|---|
| 同结果协议故事 | GraphQL FULL vs REST 全量 | 「同业务结果下,某路径可能更轻」 |
| 选择性返回故事 | GraphQL CARD / MIN vs REST 全量 | 「少字段带来体积与延迟收益」——不能叫同结果更快 |
问题空间:你在比什么
先写清「想证明什么」;证明目标一偏,后面所有数字都是噪声。
| 你想证明 | 实际常在比 | 误判一句话 |
|---|---|---|
| 协议 / 序列化路径更轻 | 少字段、少嵌套 | 「GraphQL 更快」其实是 trim |
| BFF(Backend for Frontend)合并少往返 | N 次 REST vs 1 次 GQL | 网络次数优势,不是同构延迟 |
| 某接口迁移该不该上 GraphQL | 未控 JWT、fixture、环境 | 不可复现的单次 p50 |
BFF 合并往返是合法产品故事,但要单独开栏写「少几次 HTTP 到客户端」;不要把它塞进「单请求延迟谁更低」那一栏。
类比局限先钉死:下文天平管的是对照公平性;它解释不了 GraphQL 解析器实现、DataLoader 批处理、或某网关的具体序列化成本——那些要另开实验。
心智模型:天平两边放同种砝码
对照像天平:少一颗砝码,数字再漂亮也不能上选型页。
把两边想成:
| 侧 | 放什么 |
|---|---|
| 左 · REST | 固定全量业务载荷(该接口约定返回的完整字段集) |
| 右 · GraphQL | 分档 selection:FULL / DETAIL / CARD / MIN(教学标签) |
| 共同砝码 | 同一鉴权、同一 fixture ID 集、同一环境、同一并发模型、同类缓存状态 |
常见「作弊」不是故意造假,而是砝码漏了:
| 作弊形态 | 天平实际在比 |
|---|---|
| N×单条 REST vs 1×GraphQL | 往返次数,不是同构延迟 |
| GraphQL 只选列表卡字段 vs REST 全量 | 选择性返回,不是同结果 |
| 一边 cold、一边 warm | 缓存命中噪声 |
天平类比管公平性;解释不了「解析层慢还是下游 I/O 慢」——归因要另看两边是否共用同一 service / cache。
对照矩阵:三条硬规则
同构、FULL 对齐、缓存成对——缺一条,结论最多写「观察」,不能写「协议更快」。
规则表(教学口径)
| 规则 | 说明 |
|---|---|
| 同构 | 同一业务语义、同一 N、1 HTTP ↔ 1 HTTP;同一 token、同一 fixture、同一环境 |
| 缓存成对 | 至少分别报 cold(冷) 与 warm(热);禁止混报 |
| 载荷档 | REST 固定全量;GraphQL 分档;只有 FULL 才与「同结果」挂钩 |
| 基线 | 单 VU(Virtual User,虚拟用户),每 case 足够迭代(示意 ≥50–100;以你们统计习惯为准) |
| 负载 | 固定 VU / RPS(Requests Per Second),勿只报一次尖峰 |
FULL 对齐:什么叫「同结果」
GraphQL selection 覆盖 REST 全量业务字段,且响应体积同量级,才有资格谈「同结果更快」。
教学示意阈值(可改,但评审前要写进方法说明):体积差示意 <20% 算同量级——这是讨论口径,不是行业标准。CARD / MIN 赢了,只能叫选择性返回收益,不能改口成同结果协议胜利。
判定话术(先答后释)
| 观察 | 可说的话 | 不可说的话 |
|---|---|---|
GQL FULL vs REST:bytes 同量级且 p95 稳定更低 | 同结果层面,GraphQL 路径可能更快 | 「全面碾压」 |
GQL CARD 更小更快 | 选择性返回收益;适合列表卡形态 | 「同结果更快」 |
GQL FULL 更小但 p95 更高 | 体积赢、延迟略亏 | 硬拗成全面更快 |
最少指标
| 指标 | 为什么要 |
|---|---|
| latency p50 / p95(最好加 p99) | 尖峰与尾延迟比平均数诚实 |
error rate(含 GraphQL 响应体里的 errors) | HTTP 200 仍可能业务失败;团队若把 partial data 当成功,须在方法说明里写清 |
response_bytes | 分清 trim 与协议路径 |
场景形态与结果表模板
用业务形态描述对照要点,不绑具体产品 API 路径。
| 形态 | 对照要点 |
|---|---|
| 批量资料(N 个 id → profiles) | 同 N;FULL 字段对齐 |
| 分页列表 | 同 page_size;列表常适合讲 CARD 故事 |
| 单资源详情 | FULL 公平对照与 CARD 预取对照分开写 |
| 批量 by-keys | 主同构实验位;N 分档(小批 / 中批) |
| 会话行资料 | 分页切片语义别和「一次拿齐」混比 |
每组结果建议固定列(教学模板):
| Case | Protocol | Selection | N | Cache | p50 | p95 | bytes | errors |
|---|---|---|---|---|---|---|---|---|
| batch-profiles | REST | FULL | 20 | cold | … | … | … | … |
| batch-profiles | GQL | FULL | 20 | cold | … | … | … | … |
| batch-profiles | GQL | CARD | 20 | cold | … | … | … | … |
数字格填你自己的跑数;模板的价值是强迫分栏,避免把 CARD 行的胜利抄进「协议结论」栏。
执行清单与结论标签
六步跑完,结论分三栏写:协议开销 / 选择性收益 / 该场景是否值得迁。
可复述清单:
- 固定 fixture(两边共用同一 ID 集)
- 预热 warm 路径一轮
- 单 VU 基线,足够迭代
- 再跑约定 VU × 时长
- 记录环境(运行时版本、实例规格、缓存是否同集群)
- 结论分栏:协议开销(
FULL) / 选择性收益(CARD) / 该场景是否值得迁
自动结论关键词(教学命名,非某脚本私有协议):
| 关键词 | 含义 |
|---|---|
| same-result eligible | FULL 体积差可接受且延迟更优 → 可谈协议路径 |
| field trim / volume win | 明显更小 → 只能说选字段 |
| CARD win | 选择性故事成立 |
| ERROR | 先修失败再比 |
伪流程(脱敏,非生产 API;只钉顺序):
fix_fixtures() # 两边共用
warmup_warm_path()
baseline = run(single_VU, iters>=50)
load = run(fixed_VU, duration)
assert cache_pair(cold, warm)
assert http_count_isomorphic() # 禁止 N×REST vs 1×GQL
label = classify(full_bytes_delta, p95, errors)
# same-result | field-trim | CARD-win | ERROR反模式
下面几条会把「好看数字」直接写成评审里站不住的结论。
-
用 N 次 REST 对 1 次 GraphQL 证明「GraphQL 延迟更低」
你比的是往返次数。同构要求是 1 HTTP ↔ 1 HTTP。 -
只用
CARD对 REST 全量,却写「同结果更快」
那是选择性返回故事。产品上可以很有价值,但标签写错会毁可信度。 -
cold 对 warm
混报缓存状态 ≈ 比噪声。至少成对出两行。 -
忽略 GraphQL
errors数组
HTTP 200 仍可能失败。error rate 必须把errors算进去,否则 p95「更快」可能来自半残响应。 -
把 DataLoader「少打下游」和「少 HTTP 到客户端」混为一谈
前者是服务端 fan-out(扇出)批处理,可另开实验;不与 REST 比客户端往返次数。天平管的是客户端同构,管不了下游合并策略。 -
共用同一 service / cache 时,仍把
FULL变慢归因成「业务 I/O 变慢」
更常见的嫌疑在序列化 / 解析层。若 REST 与 GraphQL 下游路径本来就不同,这条归因不成立——先画拓扑再下结论。
选型结论
- 先分清要比的故事:同结果协议 vs 选择性返回;两栏分开写,禁止揉成一句「更快」。
FULL对齐 + 成对缓存,才有资格谈协议快慢;否则最多写观察,不写选型结论。CARD/MIN的价值是产品形态(列表卡、预取摘要),不是协议宗教。- 归因时:若两边共用同一 service / cache,
FULL变慢更常指向序列化 / 解析层,而不是「业务 I/O 变慢」。 - BFF 少往返可以是独立产品论据;不要偷换成「同构单请求延迟更低」。