讲师中心 微信公众号
AI工具推荐 视频效率加速

如何解决ThinkPHP关联模型的N+1查询问题_with和withJoin预载入对比

酷瑶吖_4234

酷瑶吖_4234

发布时间:2026-03-21 06:51:19

|

871人浏览过

|

来源于php中文网

原创

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

如何解决thinkphp关联模型的n+1查询问题_with和withjoin预载入对比

为什么 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。

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

LibLibAI
LibLibAI Hot

一款AI视频创作工具,主要用于国内领先的AI创意平台,以海量模型、低门槛操作与“创作-分享-商业化”生态,让小白与专业创作者都能高效实现图文乃至视频创意表达,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

4023

2023.10.12

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

851

2023.10.27

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

1049

2024.02.23

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

5901

2024.03.06

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

2803

2024.03.06

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

5860

2024.04.07

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

7821

2024.04.29

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

1070

2024.04.29

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

80

2026.09.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn