with 默认惰性预载入导致N+1,先查主表再为每条记录发关联查询;withJoin通过LEFT JOIN一次查完避免N+1;一对多需分两步查+内存关联。

为什么 with 一用就变 N+1?
不是 with 本身有问题,而是它默认走的是「惰性预载入」:先查主表,再对每条结果单独发一条关联查询。比如查 100 个用户,with('profile') 就会执行 1 + 100 次 SQL——这就是典型的 N+1。
常见错误现象:SELECT * FROM user 后紧跟 100 次 SELECT * FROM profile WHERE user_id = ?,慢得明显,监控里 SQL 数飙升。
适用场景:关联数据量小、或只查极少数主记录(比如分页第一页且每页 5 条)时,with 简单够用;但一旦列表变长、关联嵌套加深,立刻掉坑。
-
with不会改写主 SQL,只是追加额外查询,无法利用 JOIN 减少网络往返 - 对 hasMany 关联尤其危险,1 条主记录触发 N 次子查询
- 如果关联模型还用了
where或order,with会为每个主记录重复执行带条件的子查询
withJoin 怎么避免 N+1?
withJoin 是 ThinkPHP 6.1+ 引入的真正 JOIN 预载入方式,它把主表和关联表拼成一条 LEFT JOIN SQL,一次查完所有字段,彻底消灭额外查询。
立即学习“PHP免费学习笔记(深入)”;
使用场景:需要展示列表 + 关联字段(如用户列表带昵称、文章列表带分类名)、且关联关系明确(一对一、一对多主键外键清晰)时,优先选 withJoin。
- 必须确保关联定义中
foreignKey和localKey正确,否则 JOIN 条件错,数据为空或错乱 - 不支持 hasMany 的「一对多展开」(比如一个用户有多个订单,
withJoin('orders')只能取第一条,其余被截断),这时得换方案 - JOIN 后字段同名会覆盖(如
user.id和profile.id),建议在关联定义里用alias或查询时指定field
示例:UserModel::withJoin('profile', 'LEFT')->select() 生成的是 SELECT user.*, profile.* FROM user LEFT JOIN profile ON user.id = profile.user_id。
一对多怎么破 N+1?别硬刚 withJoin
一对多(hasMany)是 withJoin 的盲区。强行用它,SQL 虽然只发一次,但结果集会爆炸:1 个用户 × 5 个订单 = 5 行,用户字段重复 5 次,PHP 层还得自己合并去重。
正确做法是「分两步查 + 内存关联」,ThinkPHP 原生支持:with(['orders' => function ($query) { $query->limit(5); }]) 还是 N+1?不,要配合 loadRelation 或手动 ID 批量查。
- 先查主表:
$users = UserModel::select() - 再批量查关联:
$userIds = array_column($users, 'id'); $orders = OrderModel::where('user_id', 'in', $userIds)->select() - 最后用 PHP 合并:
foreach ($users as &$u) { $u->orders = $orders->filter(fn($o) => $o->user_id == $u->id); }
这个模式性能稳定,不受关联数量影响,也避免了 JOIN 导致的数据膨胀。注意:务必给 user_id 加索引,否则第二步变全表扫描。
容易被忽略的坑:关联字段没查出来?
很多人写了 withJoin('profile'),但模板里访问 $user->profile->nickname 报错——不是没关联上,是 profile 字段根本没进结果集。
原因:ThinkPHP 的 withJoin 默认只 SELECT 主表字段,关联表字段要显式声明。
- 要么在关联定义里加
'field' => 'id,user_id,nickname,avatar' - 要么查询时用
field指定:UserModel::withJoin('profile', 'LEFT')->field('user.*, profile.nickname, profile.avatar')->select() - 如果用了
hidden或visible控制输出,也要确认关联模型的字段没被意外过滤
还有个隐蔽点:MySQL 8.0+ 默认开启 sql_mode=only_full_group_by,如果 JOIN 后用 GROUP BY user.id 却没把所有 SELECT 字段放进 GROUP BY,会直接报错 Expression #2 of SELECT list is not in GROUP BY clause——这时候得关 mode 或改写查询,别怀疑是框架 bug。


















