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

06.14.1 GraphQL 服务端(Schema、Resolver、N+1 与 DataLoader、订阅)

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.14 API 协议专题

覆盖范围

  • Schema 与类型系统
  • Resolver 与执行
  • N+1 问题与 DataLoader
  • 订阅(Subscription)
  • 权限与错误处理

高频题速览

编号 题目 难度 频率
06.14.1-001 GraphQL 核心概念? 基础 ★★★★
06.14.1-002 Schema 与类型系统? 基础 ★★★★
06.14.1-003 什么是 N+1 问题? 进阶 ★★★★★
06.14.1-004 DataLoader 怎么解决 N+1? 进阶 ★★★★★
06.14.1-005 Resolver 怎么执行? 进阶 ★★★
06.14.1-006 GraphQL 订阅怎么实现? 进阶 ★★★
06.14.1-007 权限在 GraphQL 怎么做? 进阶 ★★★
06.14.1-008 GraphQL 错误怎么返回? 高级 ★★★

06.14.1-001 GraphQL 核心概念?

频率 ★★★★ | 难度 基础

一句话结论

GraphQL 是 API 查询语言:客户端按需要的字段发查询,服务端按 Schema 执行并返回精确结构;一个端点解决 REST 多个端点、过度获取、版本演进问题。

概念解释

  • 类型系统:Schema 定义有哪些对象、字段、关系。
  • 查询(Query):读。
  • 变更(Mutation):写。
  • 订阅(Subscription):实时推送。

代码 / 示例

query {
  user(id: "1") {
    name
    orders {
      id
      amount
    }
  }
}

06.14.1-002 Schema 与类型系统?

频率 ★★★★ | 难度 基础

一句话结论

Schema 是 GraphQL 的类型契约:对象类型、字段、参数、标量、枚举、接口、联合;强类型自带文档与校验,工具可生成前端类型。

概念解释

  • type:对象。
  • scalar:Int/String/ID。
  • enum:枚举。
  • interface/union:多态。

06.14.1-003 什么是 N+1 问题?

频率 ★★★★★ | 难度 进阶

一句话结论

查 N 个用户的订单,先查 1 次用户列表,然后每个用户再查一次订单(共 N 次),导致 N+1 次数据库查询;这是 GraphQL Resolver 嵌套查询的典型性能陷阱。

概念解释

  • 例子:users { orders { ... } },1 次查 users,N 次查 orders。
  • 后果:数据库压力随嵌套层数线性放大。
  • 根因:每个字段的 Resolver 独立调用,不知道其他 Resolver 也在查同一类数据。

06.14.1-004 DataLoader 怎么解决 N+1?

频率 ★★★★★ | 难度 进阶

一句话结论

DataLoader 按请求(per-request)把多个 Resolver 里对同一类型的加载请求收集起来,在 tick 末尾批量合并成一次查询(如 SELECT * FROM orders WHERE user_id IN (...)),再把结果分发回各个 Resolver;同时带缓存,同一请求里重复加载同一对象不重复查。

概念解释

  • 批处理(batching):同一 tick 内多个 load(id) 合并成一次 DB 查询。
  • 缓存(caching):同一请求内 load 同一 id 返回缓存。
  • 生命周期:DataLoader 实例 per-request,不能跨请求复用(否则缓存污染)。

代码 / 示例

const userLoader = new DataLoader(async (userIds) => {
  const users = await db.users.findByIds(userIds);
  return userIds.map(id => users.find(u => u.id === id));
});
// Resolver 里:
userLoader.load(userId); // 多个 Resolver 调用合并为一次查询

常见误区

  • 误区:DataLoader 是全局单例。正解:per-request,否则用户 A 看到用户 B 的缓存。
  • 误区:返回顺序必须与请求顺序一致。正解:DataLoader 要求批量函数返回的数组与 keys 一一对应。

06.14.1-005 Resolver 怎么执行?

频率 ★★★ | 难度 进阶

一句话结论

GraphQL 引擎按查询树从顶层 Query 开始,逐字段调用对应 Resolver;父子 Resolver 异步串行(子 Resolver 拿到父返回值),但兄弟字段可并行。

概念解释

  • Resolver 签名:(parent, args, context, info) => data。
  • parent:父对象。
  • context:请求级共享(登录用户、DataLoader)。
  • info:AST 信息。

06.14.1-006 GraphQL 订阅怎么实现?

频率 ★★★ | 难度 进阶

一句话结论

订阅基于 WebSocket(graphql-ws)或 SSE:客户端发订阅 query,服务端在事件发生时通过连接推数据;底层通常用 Pub/Sub(Redis Pub/Sub)桥接业务事件与订阅连接。

概念解释

  • 协议:graphql-ws 或 SSE。
  • Pub/Sub:业务事件 → Redis → 订阅管理器推给客户端。
  • 与 WebSocket 区别:GraphQL 订阅是 GraphQL over WebSocket,Schema 化。

06.14.1-007 权限在 GraphQL 怎么做?

频率 ★★★ | 难度 进阶

一句话结论

在 context 里放登录用户,Resolver 内校验权限;字段级权限可用 directive(如 @auth)统一拦截;注意不要让客户端通过 GraphQL 绕过 REST 层的权限校验。

常见误区

  • 误区:GraphQL 一个端点就没鉴权。正解:每个 Resolver 仍要校验,甚至更细(字段级)。

06.14.1-008 GraphQL 错误怎么返回?

频率 ★★★ | 难度 高级

一句话结论

GraphQL 响应有 data 与 errors 两个顶级字段:部分字段出错时 data 仍返回(出错字段为 null),errors 数组里带 message/locations/path;业务错误用 extensions 扩展错误码,HTTP 状态通常 200。

常见误区

  • 误区:所有错误都抛 HTTP 500。正解:GraphQL 约定 HTTP 200 + errors 数组,业务错误用 extensions.code。

06.14.1-009 怎么防止恶意 GraphQL 查询?

频率 ★★★ | 难度 高级

一句话结论

限制查询深度(最大嵌套层数,如 10)、限制复杂度(每个字段计分,总分超限拒绝)、限制查询长度;防止攻击者构造深层嵌套查询打爆数据库。

概念解释

  • 深度限制:防递归嵌套。
  • 复杂度分析:字段加权,总分上限。
  • 查询长度:限制 query 字符串大小。

06.14.1-010 GraphQL 怎么分页?

频率 ★★ | 难度 进阶

一句话结论

用 Relay 风格 cursor 分页(after + first + edges),而不是 offset 分页;cursor 不暴露页码,适合大数据集且稳定。

06.14.1-011 Mutation 与 REST POST 什么关系?

频率 ★★ | 难度 基础

一句话结论

Mutation 是 GraphQL 里的写操作,语义等同 REST POST/PUT/DELETE;一次 Mutation 可以同时写多个字段并返回最新数据,减少往返。

06.14.1-012 GraphQL 怎么做分页?

频率 ★★ | 难度 进阶

一句话结论

Relay 风格 cursor 分页(after + first + edges { node cursor } + pageInfo { hasNextPage endCursor }),cursor 是不透明的位置标识,比 offset 稳定。

06.14.1-013 GraphQL 的 Subscription 怎么鉴权?

频率 ★★ | 难度 进阶

一句话结论

WebSocket 连接建立时通过 connection_init 消息带 Token,服务端验证后才允许 subscribe;后续消息按连接的用户身份处理。

06.14.1-014 GraphQL 怎么解决 N+1?

频率 ★★★ | 难度 高级

一句话结论

DataLoader 按请求批次合并查询(见 06.14.1-004),配合缓存;不要在 Resolver 里循环查库;预加载(数据批量加载)是核心手段。

06.14.1-015 GraphQL 怎么限流?

频率 ★★ | 难度 进阶

一句话结论

按用户/IP 限 QPS,按查询复杂度计分(每个字段权重),总分超限拒绝;防止恶意复杂查询打爆服务端。

06.14.1-016 GraphQL 怎么做缓存?

频率 ★★ | 难度 进阶

一句话结论

服务端缓存查询结果(按 query 哈希 + 变量),数据变更时失效;但 GraphQL 缓存复杂(字段级、关联数据),不如 REST 简单;多数场景靠客户端缓存。

06.14.1-017 GraphQL 的 Resolver 怎么组织?

频率 ★★ | 难度 基础

一句话结论

按类型组织 Resolver(UserResolver、OrderResolver),每个 Resolver 处理自己类型的字段;业务逻辑在 Service,Resolver 只做数据获取。

06.14.1-018 GraphQL 适合什么场景?

频率 ★★ | 难度 进阶

一句话结论

多端(Web/iOS/Android)需要不同字段、聚合多个资源的场景;简单 CRUD 用 REST 更简单;开放 API(第三方不确定查询需求)用 GraphQL。

06.14.1-019 GraphQL 怎么限流?

频率 ★★ | 难度 进阶

一句话结论

按用户/IP 限 QPS,按查询复杂度计分(字段权重),总分超限拒绝;防止恶意复杂查询打爆服务端。

06.14.1-020 GraphQL 怎么做缓存?

频率 ★★ | 难度 进阶

一句话结论

服务端缓存查询结果(按 query 哈希 + 变量),数据变更时失效;但 GraphQL 缓存复杂,多数场景靠客户端缓存。

06.14.1-021 Resolver 怎么组织?

频率 ★★ | 难度 基础

一句话结论

按类型组织 Resolver(UserResolver、OrderResolver),每个处理自己类型的字段;业务逻辑在 Service,Resolver 只做数据获取。

06.14.1-022 GraphQL 适合什么场景?

频率 ★★ | 难度 进阶

一句话结论

多端需要不同字段、聚合多资源的场景;简单 CRUD 用 REST 更简单;开放 API 用 GraphQL。

06.14.1-023 GraphQL 怎么分页?

频率 ★★ | 难度 进阶

考察点

  • 连接(Connection)模式、光标分页
  • 避免偏移分页的性能问题

参考答案

  • 用 cursor-based pagination:first: 10, after: "cursor"
  • 每个节点带 cursor,下一页从 cursor 开始
  • 返回 totalCount、pageInfo(hasNextPage、endCursor)
  • 比 offset 分页性能好(深分页不慢),数据不跳

追问

  • 为什么不用 offset 分页?(OFFSET 10000 扫前 1 万行很慢,新增数据会跳)

06.14.1-024 GraphQL 怎么鉴权?

频率 ★★ | 难度 进阶

考察点

  • 字段级鉴权、查询级鉴权
  • 不要在 Resolver 里手动判

参考答案

  • 全局:解析请求时验证 JWT,注入用户上下文
  • 字段级:@auth 注解或 schema directive,控制字段访问权限
  • 对象级:Resolver 里根据用户权限返回 null 或抛错
  • 不要在每个 Resolver 里手动写 if 判权限

追问

  • 字段级鉴权怎么做?(schema directive 在解析字段前校验用户权限)

06.14.1-025 GraphQL 订阅怎么实现?

频率 ★★ | 难度 进阶

考察点

  • WebSocket 传输、发布订阅
  • 实时数据推送

参考答案

  • subscription 类型定义订阅操作
  • 用 WebSocket 协议(graphql-ws)传输
  • 服务端事件触发时推送数据给订阅客户端
  • 内部用 Pub/Sub(Redis Pub/Sub 或消息队列)
  • 适合实时通知、协作编辑、实时报表

追问

  • GraphQL 订阅和 WebSocket 区别?(GraphQL 订阅是协议层,底层还是 WebSocket)

06.14.1-026 GraphQL 错误处理?

频率 ★★ | 难度 基础

考察点

  • 部分成功、错误路径、业务错误
  • 不要一个错误全失败

参考答案

  • Resolver 抛错,错误进 errors 数组,data 里对应字段为 null
  • 字段级错误不影响其他字段
  • 业务错误用自定义错误类型(带错误码、字段)
  • 客户端按 path 定位错误字段显示

追问

  • 为什么 GraphQL 返回 200 但 body 有 errors?(部分成功,HTTP 状态只表示传输成功)

待整理清单

  • [ ] 各语言 GraphQL 库(graphql-java/apollo-server)差异(待确认)
  • [ ] GraphQL 深度限制与查询复杂度(防恶意查询)
  • [ ] Federation 网关(Apollo Federation)