API 设计 / 系统课时

识别 N+1 查询

识别 N+1 查询

N+1 的危险不在于“某个 Resolver 被调用很多次”,而在于父列表返回 N 条数据后,每个子字段又触发一次独立 I/O。本课用 Resolver 调用次数、SQL 日志和链路追踪三层证据确认这种模式,并区分真正的 N+1 与正常的批量读取。

学习目标

  • 从父列表基数与子 Resolver 调用次数建立 N+1 假设
  • 在 SQL 日志中识别“同模板、不同参数”的重复查询
  • 用链路追踪确认重复 I/O 是否属于同一次 GraphQL 请求

先从调用形状建立假设

典型形状是:Query.posts 一次返回 N 篇文章,随后 Post.author 对每篇文章各查询一次作者。此时数据库访问总数约为 1 + N。字段 Resolver 被调用 N 次本身并不是错误,因为 GraphQL 本来就会逐对象解析字段;真正要追的是这 N 次调用是否各自落到数据库或远程 API。

N+1 的三层证据链

用最小复现观察 1 加 N

下面的脚本用与 GraphQL 字段 Resolver 相同的调用方式模拟父列表和作者字段,并把每次“SQL”打印出来。真实框架可能并发执行多个字段 Resolver,但重复查询的形状不会因此消失。

js
const posts = [
  { id: "p1", title: "A", authorId: "u1" },
  { id: "p2", title: "B", authorId: "u2" },
  { id: "p3", title: "C", authorId: "u1" },
];

const users = new Map([
  ["u1", { id: "u1", name: "Ada" }],
  ["u2", { id: "u2", name: "Linus" }],
]);

const db = {
  async listPosts() {
    console.log("SQL: SELECT id, title, author_id FROM posts LIMIT 3");
    return posts;
  },
  async findUserById(id) {
    console.log(`SQL: SELECT id, name FROM users WHERE id = '${id}'`);
    return users.get(id);
  },
};

const resolvers = {
  Query: {
    posts: () => db.listPosts(),
  },
  Post: {
    author: (post) => db.findUserById(post.authorId),
  },
};

async function main() {
  const rows = await resolvers.Query.posts();
  for (const post of rows) {
    await resolvers.Post.author(post);
  }
}

main().catch(console.error);

预期输出:

text
SQL: SELECT id, title, author_id FROM posts LIMIT 3
SQL: SELECT id, name FROM users WHERE id = 'u1'
SQL: SELECT id, name FROM users WHERE id = 'u2'
SQL: SELECT id, name FROM users WHERE id = 'u1'

父查询只执行一次,但作者查询随文章数量增长,而且 u1 甚至被重复读取。这就是典型 N+1:列表规模从 3 增长到 300 时,子查询数量也会近似线性增长。

在 SQL 日志里找重复模板

排查时先给一次 GraphQL 请求打上 request ID 或 trace ID,再只看这次请求产生的数据库语句。重点不是逐条读 SQL,而是找“同一语句模板在极短时间内重复出现,只是绑定参数不同”的模式,例如连续多次 WHERE id = ?。

如果数据库客户端支持 query hook,可以按规范化 SQL 模板计数;没有 hook 时,也可以先打开开发环境 SQL 日志。确认父列表返回 N 条后,再核对子查询次数是否接近 N。分页会改变 N,但不会改变这种增长关系。

用链路追踪确认它属于同一次请求

SQL 日志能证明重复查询,Trace 则能回答这些查询是否都由同一次 GraphQL operation 触发。理想的 span 至少带上 operation name、GraphQL field 或 resolver 名称、数据库操作名和父 trace;这样可以看到一个 Query.posts span 下出现大量 Post.author 与 DB 子 span。

并发执行不会让 N+1 变成“不是问题”。它可能缩短单次请求的墙钟时间,却会把几十或几百个查询同时压到连接池和数据库上,因此仍需治理。

排除看起来相似的正常模式

以下现象不能单独判定为 N+1:一个字段 Resolver 被调用很多次但命中请求级缓存;底层把多个 key 合成一次 WHERE id IN (...);或者固定执行少量与 N 无关的查询。真正的判断标准是独立 I/O 次数是否随父列表元素数量增长。

确认 N+1 后,再考虑请求级批处理与缓存、Repository 批量接口或 SQL join。修复前后应使用同一 GraphQL 查询和相同列表规模复测,目标是把查询次数从 1 + N 压到常数级或少量批次,而不仅仅是让某次运行看起来更快。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

识别 N+1 查询

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通