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

解决LaravelN+1查询问题提升页面加载速度【必会】

老涛大大_1769

老涛大大_1769

发布时间:2026-07-11 19:00:29

|

748人浏览过

|

来源于php中文网

原创

N+1问题必然发生而非可能,解决核心是with()位置正确、字段精简、外键有索引:with()须在get()前且关系名严格匹配;关联字段只选必要列;所有外键及复合查询条件必须建索引。

解决laraveln+1查询问题提升页面加载速度【必会】

直接说结论:N+1 不是“可能出问题”,而是“只要没预加载,就一定出问题”。页面从 3 秒降到 30 毫秒,核心就三件事——with() 写对位置、字段精简到最小必要、外键必须有索引。

with() 必须写在 get() 前,且关系名要完全匹配

常见错误是把 with() 放在 get() 之后,比如 User::get()->with('posts'),这完全无效。Eloquent 只在构建查询阶段解析预加载,执行完 get() 后模型已落地,with() 就只是个无意义调用。

  • 正确顺序:User::with('posts')->get(),或带分页:User::with('posts')->paginate(20)
  • 关系名必须和模型里定义的函数名一致,比如 public function posts() → 只能写 'posts',不能写 'post' 或 'Posts'
  • 嵌套关系必须写全路径:'posts.comments.author',不是 'posts' 加 'comments' 两个独立字符串——后者会尝试加载 User 的 comments 关系(很可能不存在),报错或静默失败
  • belongsTo 关系最容易漏,比如 Post 模型里 user() 方法,模板中写 {{ $post->user->name }} 却没 with('user'),立刻触发 N+1

字段不精简,预加载反而更慢

with() 默认对关联表执行 SELECT *,如果 posts 表有 content(TEXT)、json_data(JSON)这类大字段,一次查 100 条 posts 就拖回几百 MB 数据,网络和内存都吃紧。索引再好也救不了传输瓶颈。

Laravel
Laravel

避免常见的Laravel错误:N+1查询、批量赋值、缓存陷阱及队列序列化陷阱。

下载
  • 主查询也要限制字段:User::select('id', 'name', 'email')->with(...)->get()
  • 关联查询必须包含外键:with(['posts' => function ($q) { $q->select('id', 'title', 'user_id'); }]) —— 缺了 user_id,Eloquent 无法把 posts 绑定到对应 user 上
  • 避免敏感字段泄露:with(['profile' => function ($q) { $q->select('id', 'user_id', 'avatar'); }]),别让 password_hash 跟着一起查出来
  • 多对多中间表字段也要精简,比如 user_role 表只取 user_id 和 role_id,别查 created_at 之类非必需字段

withCount() 和 load() 不是 with() 的替代品,是不同场景的解法

看到 “评论数” 就下意识写 $post->comments->count()?那是典型 N+1。但反过来,所有场景都硬上 with('comments') 也不对——你只需要数字,却拉回全部评论记录,浪费严重。

  • 只统计数量:withCount('comments') → 返回 $post->comments_count,底层是 COUNT(*) 子查询,1 次搞定
  • 带条件统计:withCount(['comments as approved_comments' => function ($q) { $q->where('approved', true); }])
  • load() 是补救动作,不是初始策略:$posts = Post::where('status', 'draft')->get() 之后,管理员才需要看评论,这时再 $posts->load('comments');但 Post::query()->load('user') 会直接报错,因为 load() 只接受 Eloquent Collection 或 Model 实例
  • with() 之后又 $post->load('posts'),会多发一次查询——Eloquent 不自动 dedupe,它只认自己是否预加载过,不认你手动 load 过没

没索引的 with(),等于给慢查询加速

加了 with('posts'),但 posts.user_id 没索引?那 IN (1,2,3,...,1000) 查询就是全表扫描,预加载越狠,慢得越彻底。EXPLAIN 显示 type: ALL 就是铁证。

  • 检查外键索引:SHOW INDEX FROM posts;,确认 user_id 列有 KEY
  • 多对多表(如 category_post)必须建联合索引:ALTER TABLE category_post ADD INDEX idx_category_post (category_id, post_id);
  • 复合查询(比如 where('status', 'published')->orderBy('created_at'))需要 (status, created_at) 索引,单建 status 索引没用
  • 用 Laravel Debugbar 或 Telescope 查看慢查询详情,重点盯 WHERE 条件字段是否命中 key,rows 是否远大于实际结果数

真正卡住人的,从来不是要不要用 with(),而是嵌套层级一深,字段一多,索引一缺,with() 就变成性能黑洞。动手前先开 Debugbar 看真实 SQL,比凭感觉改代码管用十倍。

热门AI工具

更多
Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

WorkBuddy

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

DeepSeek

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

豆包大模型

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

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

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

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

9304

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

5621

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2035

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

3508

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

4174

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

3271

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

4657

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

3622

2023.11.13

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

60

2026.09.23

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
如何安装 Composer
如何安装 Composer

共1课时 | 181人学习

Composer手册
Composer手册

共0课时 | 0人学习

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

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