Laravel Spatie：如何一次性预加载用户的角色与权限？使用with()预加载失效问题求助

首先明确回答：完全可以用with()方法一次性预加载用户的角色和权限，你的思路是对的，代码无法运行的问题出在when()闭包的写法上，我帮你梳理下问题和修正方案：

问题分析 #

你在when()闭包里重新赋值了$user = $user->where(...)，但Laravel的查询构建器闭包需要返回修改后的查询实例，如果不返回的话，当q参数存在时，这个条件不会被应用到查询链中，甚至可能导致后续的查询方法失效。

修正后的代码 #

$user = User::with(['roles', 'permissions'])
    ->when(request()->q, function ($query) {
        // 直接返回添加了where条件的查询实例，无需重新赋值
        return $query->where('name', 'like', '%' . request()->q . '%');
    })
    ->latest()
    ->paginate(20);

额外注意事项 #

1. 确保模型关联正确
   要保证你的User模型已经正确定义了与Role和Permission的关联关系，比如多对多关联：

   // app/Models/User.php
   public function roles()
   {
       return $this->belongsToMany(Role::class);
   }
   
   public function permissions()
   {
       return $this->belongsToMany(Permission::class);
   }
   

2. 嵌套预加载（如果权限通过角色关联）
   如果你的权限是挂在角色下的（用户拥有角色，角色拥有权限），可以用嵌套预加载一次性拉取所有关联数据，进一步优化性能：

   $user = User::with('roles.permissions')
       ->when(request()->q, function ($query) {
           return $query->where('name', 'like', '%' . request()->q . '%');
       })
       ->latest()
       ->paginate(20);
   

3. 更安全的写法优化

   • 用request()->input('q')替代request()->q，避免参数不存在时产生错误；
   • Laravel 9+支持whereLike方法，简化模糊查询：

     return $query->whereLike('name', request()->input('q'));
     

内容的提问来源于stack exchange，提问作者shinichirou ikebe