Laravel模型关联预加载？预加载怎样使用？

答案：Laravel模型关联预加载通过with()等方法一次性加载关联数据，避免N+1查询问题。当获取文章列表并显示作者时，未预加载会执行1+N次查询，使用with('author')后仅需2次查询，显著提升性能。还可预加载多个、嵌套关联，添加约束条件，或使用load()延迟加载。但需避免过度预加载导致内存浪费，大型关联应分页处理，$with属性慎用以防不必要的开销。

Laravel模型关联预加载，简单来说，就是一种优化数据库查询性能的策略，它能有效避免臭名昭著的N+1查询问题。其核心在于，当你需要获取一个模型及其关联模型的数据时，不是对每个主模型都单独发起一次关联查询，而是通过少量（通常是两次）查询，一次性将所有主模型和它们对应的关联模型数据都取出来。使用上，最常见也是最基础的方式就是利用Eloquent模型上的

with()

在构建复杂的Web应用时，我们经常需要展示一个模型和它所关联的其他模型的数据。想象一下，你有一个博客系统，需要在一个页面上列出所有的文章，并且每篇文章旁边都显示作者的名字。如果你的代码是这样写的：

$posts = Post::all();
foreach ($posts as $post) {
    echo $post->title . ' by ' . $post->author->name;
}

这里就隐藏着一个性能陷阱，也就是所谓的N+1查询问题。

Post::all()

$post

$post->author

预加载（Eager Loading）正是为解决这个问题而生的。通过

with('author')

为什么我们需要预加载？理解N+1查询问题及其影响

N+1查询问题，听起来像个数学题，但在数据库操作中，它却是个实实在在的性能杀手。它的本质是，当你遍历一个集合（N个主模型）时，对集合中的每个元素都执行一个独立的查询来获取其关联数据（+1次查询）。这导致的总查询次数是1（获取主模型集合）+ N（获取每个关联模型）次。

我个人在开发中就遇到过这样的场景：一个后台管理系统，需要展示一个订单列表，每个订单都要显示其对应的客户信息。最初没注意，直接在循环里访问

$order->customer->name

这种问题的影响是多方面的：

• 数据库负载过高： 每次查询都需要与数据库建立连接、解析SQL、执行查询、返回结果。大量的短查询会频繁占用数据库资源，导致数据库服务器CPU、内存、I/O压力剧增。
• 页面加载缓慢： 数据库查询是Web应用中最常见的瓶颈之一。查询次数越多，总的查询时间就越长，直接体现在用户等待页面加载的时间上。
• 资源浪费： 每次查询的网络往返（Round Trip Time, RTT）也会消耗时间。N+1查询意味着更多的网络通信开销。
• 难以扩展： 随着数据量的增长，N+1问题的影响会呈线性甚至指数级恶化，使得系统难以承载更大的流量和数据规模。

所以，预加载不仅仅是一个优化技巧，它在很多情况下是保证应用性能和可扩展性的基本要求。

Laravel中预加载的多种姿势：从基础到高级用法

Laravel的Eloquent ORM为预加载提供了非常灵活且强大的支持，远不止

with('relation')

最基础的用法，我们前面已经提到了：

度加剪辑

度加剪辑（原度咔剪辑），百度旗下AI创作工具

63

查看详情

// 获取所有文章及其作者
$posts = App\Models\Post::with('author')->get();

// 获取特定ID的文章及其作者
$post = App\Models\Post::with('author')->find(1);

预加载多个关联关系： 如果一个模型有多个关联需要预加载，可以传入一个数组：

// 获取所有文章，同时预加载作者和分类
$posts = App\Models\Post::with(['author', 'category'])->get();

嵌套预加载： 当关联关系本身也有关联时，可以使用点语法进行嵌套预加载：

// 获取所有用户，预加载他们的文章，并且每篇文章再预加载评论
$users = App\Models\User::with('posts.comments')->get();

这里需要注意的是，

posts

comments

User

Post

约束预加载： 有时你只想预加载符合特定条件的关联模型。这可以通过给

with()

// 获取所有用户，但只预加载他们已发布的文章
$users = App\Models\User::with(['posts' => function ($query) {
    $query->where('published', true)->orderBy('created_at', 'desc');
}])->get();

这个闭包内部的

$query

Post

where

orderBy

默认预加载（

$with

$with

class Post extends Model
{
    protected $with = ['author'];

    // ...
}

这样，每次查询

Post

author

with()

延迟预加载（Lazy Eager Loading）： 有时候，你可能在获取了主模型集合之后，才决定需要加载某个关联关系。这时可以使用

load()

$posts = App\Models\Post::all(); // 此时没有预加载
// ... 一些操作 ...
$posts->load('author'); // 现在为所有已获取的posts预加载作者

load()

with()

条件预加载（Conditional Eager Loading）：

loadMissing()

load()

$post = App\Models\Post::find(1);
// ... 某些操作可能已经加载了author ...
$post->loadMissing('author'); // 如果author还没加载，就加载它

预加载的性能考量与潜在陷阱：何时该用，何时该慎用？

预加载无疑是提升Laravel应用性能的利器，但就像任何强大的工具一样，它并非万能，也有其适用的边界和潜在的陷阱。

何时应该使用预加载：

• 当你需要展示一个模型集合及其关联数据时，几乎总是应该使用预加载。 这是最典型的N+1问题场景。例如，一个文章列表需要显示作者、分类；一个订单列表需要显示客户、商品详情。
• 当你确定关联数据在后续代码中会被频繁访问时。 即使不是直接在循环中展示，如果业务逻辑需要对关联数据进行多次操作，预加载也能减少重复查询。
• 在API接口中，如果你知道前端需要某个关联数据。 提前预加载可以减少API调用次数和响应时间。

何时应该慎用或注意预加载：

• 过度预加载（Over-Eager Loading）： 这是最常见的陷阱。如果预加载了大量的关联关系，但实际上在当前页面或业务逻辑中只用到了其中一小部分，那么就会白白消耗数据库资源和内存。例如，你可能预加载了一个

  User

  登录后复制
  模型的所有

  posts

  登录后复制
  ，但页面上只需要显示用户头像和名字。
  • 解决方案： 仔细分析需求，只预加载实际需要的数据。甚至可以进一步通过

    select()

    登录后复制
    方法只加载关联模型中特定的字段，例如：

    Post::with('author:id,name,email')->get()

    登录后复制
    。
• 预加载大型关联集合： 即使使用了预加载，如果一个主模型关联了成千上万条数据（例如，一个用户有几十万条日志），一次性预加载所有这些数据仍然可能导致内存溢出或查询时间过长。
  • 解决方案： 对于这类大型关联，考虑使用分页（

    paginate()

    登录后复制
    ）或延迟加载（

    lazy()

    登录后复制
    ）来分批获取数据，或者使用

    withCount()

    登录后复制
    、

    withExists()

    登录后复制
    等聚合方法，只获取关联数据的统计信息，而不是所有实际数据。
• 复杂的嵌套预加载约束： 虽然Laravel支持复杂的闭包约束，但过度复杂的嵌套约束可能会让查询变得难以理解和维护。有时，将其拆分成多个独立查询，或者在业务逻辑层进行数据处理，反而更清晰。
• 默认预加载（

  $with

  登录后复制
  ）的滥用： 虽然方便，但如果一个模型被广泛使用，而其

  $with

  登录后复制
  属性中定义的关联关系并非在所有场景下都需要，那么就会导致不必要的开销。我通常只对那些几乎在所有场景下都不可或缺的、且数据量不大的关联关系使用

  $with

  登录后复制
  。

我个人的经验是，在开发初期，可以先不考虑预加载，让代码跑起来。当发现性能瓶颈时，再通过Laravel Debugbar、Xdebug等工具定位N+1问题，然后有针对性地引入预加载。不要盲目地给所有关联都加上

with()

以上就是Laravel模型关联预加载？预加载怎样使用？的详细内容，更多请关注php中文网其它相关文章！