如何提升Laravel中角色与权限的性能

1. 缓存用户权限集合 #

每次请求都从数据库拉取全量权限是核心性能损耗点，把用户的权限集合缓存起来，仅在权限/角色变更时更新缓存即可。

• 实现方式（在用户模型中封装缓存逻辑）：

// User.php
use Illuminate\Support\Facades\Cache;

public function getPermissionsAttribute()
{
    return Cache::rememberForever('user_permissions_' . $this->id, function () {
        return $this->role->permissions->pluck('name')->toArray();
    });
}

• 权限变更时清除缓存（比如在Role模型的事件中处理）：

// Role.php
public static function boot()
{
    parent::boot();
    static::saved(function ($role) {
        // 清除该角色下所有用户的权限缓存
        $role->users->each(function ($user) {
            Cache::forget('user_permissions_' . $user->id);
        });
    });
}

2. 预加载用户关联的角色与权限 #

避免N+1查询，在用户认证阶段一次性预加载角色和权限，后续视图直接调用预加载好的数据。

• 在登录逻辑中预加载：

// 登录控制器
public function login(Request $request)
{
    // 验证逻辑...
    $user = User::with('role.permissions')->where('email', $request->email)->first();
    Auth::login($user);
    // ...
}

• 或者通过Auth服务提供者全局预加载：

// AuthServiceProvider.php
use Illuminate\Support\Facades\Auth;

public function boot()
{
    $this->registerPolicies();

    Auth::extend('session', function ($app, $name, array $config) {
        return new SessionGuard($name, Auth::createUserProvider($config['provider']), $app['session.store'], $app['request']);
    });

    Auth::loginUsingId(function ($user) {
        $user->load('role.permissions');
        return $user;
    });
}

3. 用Laravel Gate/Policy封装权限判断 #

不要在视图里直接写数据库查询逻辑，把权限判断封装到Gate或Policy中，内部复用缓存/预加载的权限数据，代码更整洁且性能更优。

• 定义Gate规则：

// AuthServiceProvider.php
use Illuminate\Support\Facades\Gate;

public function boot()
{
    $this->registerPolicies();

    Gate::define('access-view', function ($user, $permissionName) {
        return in_array($permissionName, $user->permissions);
    });
}

• Blade视图中调用：

@if(Gate::allows('access-view', 'view_dashboard'))
    <!-- 仪表盘内容 -->
@endif

4. 将权限存入会话 #

如果权限不会频繁变更，可以把用户权限集合存入Session，每次请求直接从会话读取，完全绕过数据库查询。

• 登录时存入会话：

// 登录控制器
public function login(Request $request)
{
    // 验证逻辑...
    $user = User::with('role.permissions')->first();
    session(['user_permissions' => $user->role->permissions->pluck('name')->toArray()]);
    Auth::login($user);
    // ...
}

• 视图中判断权限：

@if(in_array('view_dashboard', session('user_permissions', [])))
    <!-- 显示对应内容 -->
@endif

• 登出时清除会话数据：

public function logout(Request $request)
{
    $request->session()->forget('user_permissions');
    Auth::logout();
    // ...
}

5. 数据库层面优化 #

• 给role_permission表的role_id和permission_id添加联合索引，加速权限关联查询：

ALTER TABLE role_permission ADD INDEX idx_role_permission (role_id, permission_id);

• 确保users表的role_id字段有索引，加快用户与角色的关联查询。

内容的提问来源于stack exchange，提问作者MahmouUd Ahmed