在多对多关联场景中，经常会出现“只加载一部分关联数据”的需求。以用户和角色为例，一个用户可以拥有多个角色，但页面上可能只需要展示前两个角色；以商品和标签为例，列表页希望每个商品只附带热度最高的三个标签。Eloquent 提供的 belongsToMany 关系默认会加载所有关联记录，如果不加控制，轻则带来不必要的数据传输，重则拖慢整个页面的响应速度。下面结合具体代码，分析几种可行的限制方案及其适用边界。
多对多关系的默认行为与全局限制
先定义一个典型的多对多关系。假设有 User 和 Role 两个模型，中间表为 role_user，模型关联写法如下：
// app/Models/User.php
class User extends Authenticatable
{
public function roles()
{
return $this->belongsToMany(Role::class, 'role_user', 'user_id', 'role_id')
->withPivot('assigned_at')
->withTimestamps();
}
}
当调用 User::with('roles')->get() 时，Eloquent 会为每个用户查询出全部关联的角色。如果角色表有几百条数据，而每个用户通常只有少数几个角色，这样的加载方式勉强可以接受；但如果是一个用户拥有成百上千个标签、文章收藏等场景，全量加载就会产生巨大浪费。
最简单的限制方式是在关联方法中直接添加 where 条件，例如：
public function activeRoles()
{
return $this->belongsToMany(Role::class, 'role_user', 'user_id', 'role_id')
->where('active', 1);
}
这种方式把所有用户限制在“角色状态为启用”的范围内，属于全局限制。它适合过滤条件对所有父模型相同的情况，比如只加载激活的角色、只加载未删除的角色。但如果需求是“每个用户返回自己创建时间最近的前三个角色”，这种全局 where 就无能为力了，因为数量限制需要按父模型分别计算。
使用预加载约束为每个父模型统一限制数量
预加载约束是 Laravel 提供的灵活机制，可以在 with() 方法中通过闭包定制关联查询。例如要让每个用户只加载最近创建的两个角色，可以这样写：
$users = User::with(['roles' => function ($query) {
$query->latest('role_user.created_at')->limit(2);
}])->get();
乍一看这段代码似乎能正常工作，但实际执行时，Eloquent 并不会把所有用户合并成一条 SQL 然后统一应用 limit。它会先查询所有用户，再根据用户 id 集合执行一条关联查询，类似 select * from roles inner join role_user on ... where role_user.user_id in (1,2,3,4...) order by created_at desc。然后 Eloquent 在内存中把结果按父模型进行分组。
因此，上面闭包中的 limit(2) 会被应用到整个关联查询的结果集上，而不是每个父模型。这意味着如果查询出 10 个用户，最终关联结果总条数可能只有 2 条，而不是每个用户 2 条。这与预期的行为完全不同。要真正实现“每个父模型取固定条数”，需要采用子查询或窗口函数的方法。
不过，预加载约束仍然适合另一种常见的限制：按条件过滤数据，例如每个用户只加载属于特定项目的角色：
$projectId = request('project_id');
$users = User::with(['roles' => function ($query) use ($projectId) {
$query->where('role_user.project_id', $projectId);
}])->get();
这类过滤条件对每个用户是相同的，所以可以安全地放在约束闭包中。一旦涉及到“每个父模型限制条数不同”或者“每个父模型取排序后的前 N 条”，就必须跳出预加载约束的思维模式。
借助窗口函数实现按父模型分组限制
对于数据库中每个父模型需要取固定数量的场景，SQL 的窗口函数是最直接的方案。以 MySQL 8.0 或 PostgreSQL 为例，可以使用 ROW_NUMBER() 按 pivot 表的 user_id 分组，并对每个分组内的角色按创建时间排序。具体思路是先写一个子查询为每个关联记录打上行号，再筛选行号小于等于 N 的记录。
下面给出一个完整的 Eloquent 实现示例。假设我们要为每个用户加载最近创建的两个角色，可以直接在模型上定义一个新的关联方法：
use Illuminate\Database\Eloquent\Relations\BelongsToMany;
use Illuminate\Support\Facades\DB;
public function latestTwoRoles(): BelongsToMany
{
return $this->belongsToMany(Role::class, 'role_user', 'user_id', 'role_id')
->join(DB::raw('(
SELECT role_id, user_id,
ROW_NUMBER() OVER (
PARTITION BY user_id
ORDER BY created_at DESC
) AS rn
FROM role_user
) as ranked'), function ($join) {
$join->on('ranked.user_id', '=', 'role_user.user_id')
->on('ranked.role_id', '=', 'role_user.role_id');
})
->where('ranked.rn', '<=', 2);
}
上面的代码先把 role_user 中间表按照 user_id 分区，在每个分区内按 created_at 倒序排序并生成行号 rn。然后通过 join 把行号关联回原中间表，最后筛选 rn <= 2。这样得到的关联结果就是每个用户的前两个角色。
这种方案的优点是真正在数据库层面完成了“分组限制”，不会产生额外的内存处理，性能表现良好。缺点是 SQL 比较复杂，而且依赖数据库支持窗口函数（MySQL 需要 8.0 以上，MariaDB 10.2+，PostgreSQL、SQL Server 均支持）。如果项目还在使用较老的 MySQL 版本，可以考虑用用户变量模拟行号，但可读性更差。
另外，如果每个父模型需要限制的数量不同，比如用户 A 取 3 个，用户 B 取 5 个，仅靠固定数字 2 无法满足需求。这时可以把每个用户的限额存储在实际数据表中，并在 where 子句里比较 rn <= user_limits.allowed_count，但需要额外的关联操作，复杂度会上升。
轻量方案：集合截断与访问器配合
当数据量不大，或者关联数据已经在内存中时，可以直接对已经加载的集合进行截断。比如：
$users = User::with('roles')->get();
$users->each(function ($user) {
$user->setRelation('roles', $user->roles->sortByDesc('pivot.created_at')->take(2));
});
这种方式的实现成本很低，但问题很明显：数据库查询仍然会一次性取出所有关联数据，只是最后在 PHP 端截断。如果用户量很大、关联角色很多，内存占用和查询时间依然很高。因此它只适合小规模数据或者接口响应要求不高的内部工具。
还可以定义一个访问器，在访问 roles 属性时自动截断，例如：
public function getLimitedRolesAttribute()
{
return $this->roles->sortByDesc('pivot.created_at')->take(2)->values();
}
然后在序列化用户模型时使用 $user->limited_roles 而不是 $user->roles。但访问器依赖已经加载的 roles 关联，如果关系未加载，访问器还会触发延迟加载，需要注意避免 N+1。同时，访问器的返回值是集合，在 toArray 或 JSON 输出时可能丢失关联模型的一些结构信息。
总结与选择建议
面对“为每个父模型限制关联数据”的需求，没有一种方案能覆盖所有场景，需要根据项目的数据库版本、数据规模和性能要求权衡：
- 全局过滤条件（如只加载启用状态的关联）：直接在关联定义中添加 where，简单可靠。
- 每个父模型统一数量限制：优先考虑窗口函数方案，数据库层面解决，性能最好。
- 每个父模型不同数量限制：需要引入限额表或额外字段，并结合窗口函数或子查询实现，复杂度较高，建议在确实必要时才使用。
- 小规模或临时需求：可以采用集合截断，但要注意性能隐患。
最后有一点需要提醒：使用预加载约束时，不要把 limit 或 take 直接放在闭包里，因为那不会产生每个父模型独立限制的效果。理解这一点，可以避免很多隐蔽的数据错误。
Laravel Eloquent多对多关系限制关联数据修改时间：2026-10-05 18:03:17