别用「N 次 REST」证明 GraphQL 更快

别用「N 次 REST」证明 GraphQL 更快

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 批处理、或某网关的具体序列化成本——那些要另开实验。


心智模型:天平两边放同种砝码

对照像天平:少一颗砝码,数字再漂亮也不能上选型页。

公平对照与常见作弊的天平对比图
公平对照与常见作弊的天平对比图 · 点击查看 SVG 原图

把两边想成:

侧放什么
左 · REST固定全量业务载荷(该接口约定返回的完整字段集)
右 · GraphQL分档 selection:FULL / DETAIL / CARD / MIN(教学标签)
共同砝码同一鉴权、同一 fixture ID 集、同一环境、同一并发模型、同类缓存状态

常见「作弊」不是故意造假,而是砝码漏了:

作弊形态天平实际在比
N×单条 REST vs 1×GraphQL往返次数,不是同构延迟
GraphQL 只选列表卡字段 vs REST 全量选择性返回,不是同结果
一边 cold、一边 warm缓存命中噪声

天平类比管公平性;解释不了「解析层慢还是下游 I/O 慢」——归因要另看两边是否共用同一 service / cache。


对照矩阵:三条硬规则

同构、FULL 对齐、缓存成对——缺一条,结论最多写「观察」,不能写「协议更快」。

同结果协议故事与选择性返回故事分栏
同结果协议故事与选择性返回故事分栏 · 点击查看 SVG 原图

规则表(教学口径)

规则说明
同构同一业务语义、同一 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 赢了,只能叫选择性返回收益,不能改口成同结果协议胜利。

判定话术(先答后释)

从体积差到 p95 再到结论标签的判定漏斗
从体积差到 p95 再到结论标签的判定漏斗 · 点击查看 SVG 原图
观察可说的话不可说的话
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 分档(小批 / 中批)
会话行资料分页切片语义别和「一次拿齐」混比

每组结果建议固定列(教学模板):

CaseProtocolSelectionNCachep50p95byteserrors
batch-profilesRESTFULL20cold…………
batch-profilesGQLFULL20cold…………
batch-profilesGQLCARD20cold…………

数字格填你自己的跑数;模板的价值是强迫分栏,避免把 CARD 行的胜利抄进「协议结论」栏。


执行清单与结论标签

六步跑完,结论分三栏写:协议开销 / 选择性收益 / 该场景是否值得迁。

可复述清单:

  1. 固定 fixture(两边共用同一 ID 集)
  2. 预热 warm 路径一轮
  3. 单 VU 基线,足够迭代
  4. 再跑约定 VU × 时长
  5. 记录环境(运行时版本、实例规格、缓存是否同集群)
  6. 结论分栏:协议开销(FULL) / 选择性收益(CARD) / 该场景是否值得迁

自动结论关键词(教学命名,非某脚本私有协议):

关键词含义
same-result eligibleFULL 体积差可接受且延迟更优 → 可谈协议路径
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

反模式

下面几条会把「好看数字」直接写成评审里站不住的结论。

  1. 用 N 次 REST 对 1 次 GraphQL 证明「GraphQL 延迟更低」
    你比的是往返次数。同构要求是 1 HTTP ↔ 1 HTTP。

  2. 只用 CARD 对 REST 全量,却写「同结果更快」
    那是选择性返回故事。产品上可以很有价值,但标签写错会毁可信度。

  3. cold 对 warm
    混报缓存状态 ≈ 比噪声。至少成对出两行。

  4. 忽略 GraphQL errors 数组
    HTTP 200 仍可能失败。error rate 必须把 errors 算进去,否则 p95「更快」可能来自半残响应。

  5. 把 DataLoader「少打下游」和「少 HTTP 到客户端」混为一谈
    前者是服务端 fan-out(扇出)批处理,可另开实验;不与 REST 比客户端往返次数。天平管的是客户端同构,管不了下游合并策略。

  6. 共用同一 service / cache 时,仍把 FULL 变慢归因成「业务 I/O 变慢」
    更常见的嫌疑在序列化 / 解析层。若 REST 与 GraphQL 下游路径本来就不同,这条归因不成立——先画拓扑再下结论。


选型结论

  1. 先分清要比的故事:同结果协议 vs 选择性返回;两栏分开写,禁止揉成一句「更快」。
  2. FULL 对齐 + 成对缓存,才有资格谈协议快慢;否则最多写观察,不写选型结论。
  3. CARD / MIN 的价值是产品形态(列表卡、预取摘要),不是协议宗教。
  4. 归因时:若两边共用同一 service / cache,FULL 变慢更常指向序列化 / 解析层,而不是「业务 I/O 变慢」。
  5. BFF 少往返可以是独立产品论据;不要偷换成「同构单请求延迟更低」。