本文介绍在 laravel 中通过 eloquent 关系预加载（with）一次性获取所有用户及其关联角色的正确方法，避免 n+1 查询问题，并提供按角色筛选用户的实用示例。
本文介绍在 laravel 中通过 eloquent 关系预加载（with）一次性获取所有用户及其关联角色的正确方法，避免 n+1 查询问题，并提供按角色筛选用户的实用示例。
在 Laravel 中实现多对多（n:n）关系（如 users ↔ roles）时，若需批量获取多个用户各自拥有的全部角色，关键在于合理利用 Eloquent 的关系预加载机制，而非在循环中逐个查询角色——否则将触发严重的 N+1 查询问题，显著拖慢响应速度。
首先，确保模型已正确定义关系。例如，在 User 模型中应声明：
// app/Models/User.php
public function roles()
{
return $this->belongsToMany(Role::class, 'role_user', 'user_id', 'role_id');
}同理，Role 模型中可定义反向关系（非必需，但推荐）：
// app/Models/Role.php
public function users()
{
return $this->belongsToMany(User::class, 'role_user', 'role_id', 'user_id');
}✅ 推荐做法：使用 with() 预加载角色
use App\Models\User;
// 一次性获取所有用户及其全部角色（含自动去重与关联）
$users = User::with('roles')->get();
foreach ($users as $user) {
echo "<h3>{$user->name}</h3>";
if ($user->roles->isNotEmpty()) {
foreach ($user->roles as $role) {
echo "<li>{$role->name}</li>";
}
} else {
echo "<li>（无角色）</li>";
}
}该方式仅执行 2 条 SQL 查询：1 条查 users，1 条查所有关联的 roles（通过 role_user 中间表关联），极大提升性能。
? 进阶用法：筛选具有特定角色的用户
若需获取拥有某角色（如 'admin'）的所有用户，并同时加载其全部角色（不仅限于匹配的那个），可结合 whereHas() 与 with()：
$users = User::with('roles')
->whereHas('roles', fn ($q) => $q->where('name', 'admin'))
->get();
foreach ($users as $user) {
echo "<strong>{$user->name}</strong> → ";
echo implode(', ', $user->roles->pluck('name')->toArray()) . '<br>';
}⚠️ 注意事项：
- 确保数据库中间表（如
role_user）命名与字段名与belongsToMany()参数一致； - 若角色名存在大小写敏感或空格问题，建议在数据库层面加索引并统一规范命名；
- 生产环境务必启用查询日志（
DB::enableQueryLog()）或使用 Laravel Telescope 验证是否真正避免了 N+1； - 如需返回结构化数据（如 API 响应），推荐使用资源类（
UserResource）或toArray()+append()显式控制输出字段。
综上，with('roles') 是批量获取用户角色的核心技巧；配合 whereHas() 可灵活实现条件筛选。掌握这一模式，不仅能解决当前需求，也为处理其他多对多关系（如权限、标签、分类等）奠定坚实基础。
