N+1 查询问题:循环中过多查询
快速摘要
你获取 N 条记录然后每条记录发一个查询加载相关数据 —— 这导致 N+1 次查询而非一次连接。
为什么发生
在父记录循环内逐条懒加载相关数据
ORM 懒加载配置在每次访问相关实体时触发单独查询
开发者未对相关数据使用连接或批量加载策略
最小示例
✗ 错误代码
const users = await db.query('SELECT * FROM users');
for (const user of users) {
user.orders = await db.query('SELECT * FROM orders WHERE user_id = $1', [user.id]); // N queries!
}✓ 修复代码
const users = await db.query('SELECT * FROM users');
const orders = await db.query('SELECT * FROM orders WHERE user_id = ANY($1)', [users.map(u => u.id)]);
// Group orders by user_id and assign
const ordersByUser = {};
for (const order of orders) { (ordersByUser[order.user_id] ||= []).push(order); }
for (const user of users) { user.orders = ordersByUser[user.id] || []; }将相关数据获取批量合并为带 WHERE user_id IN (...) 的单次查询,将 N+1 次查询减少为总共 2 次查询。
如何诊断
启用查询日志并计算典型请求执行的查询数量
查找一次查询后跟 N 次相关数据查询的模式
使用查询分析器或 APM 工具自动检测 N+1 模式
如何修复
使用 JOIN 在单次查询中获取父数据和相关数据
在 ORM 中使用预加载或预取指令批量加载相关数据
批量获取相关数据:收集所有外键,然后用 WHERE id IN (...) 查询
如何预防
对总是与父记录一起需要的相关数据使用预加载或连接
在开发中监控查询数量并在部署前测试 N+1 模式