Laravel中如何设计嵌套关联的用户角色权限数据库表？

现有设计存在的问题 #

• 你当前的role表实际是用户-角色关联中间表，缺少独立的角色基础信息表，后续无法扩展角色属性
• 任务权限表没有和角色/用户做关联，同一个task_id下的多条权限记录无法区分归属，无法实现不同用户/角色的独立权限配置
• 权限以数组格式存储，可读性差，无法直接通过SQL做权限相关的条件查询，查询效率低

优化后的数据库设计 #

核心表结构 #

1. 用户表（users）（默认已存在）：主键id，存储用户基础信息
2. 角色表（roles）：字段id、role_name、description，存储角色的基础定义
3. 用户-角色中间表（user_roles）：对应你之前的role表，字段id、user_id、role_id，添加联合唯一索引(user_id, role_id)避免重复关联
4. 模块表（modules）：字段id、module_name、parent_id（支持层级模块）、route，存储模块基础信息
5. 角色-模块中间表（role_modules）：和你现有结构一致，字段id、role_id、module_id，添加联合唯一索引(role_id, module_id)
6. 任务表（tasks）：字段id、task_name、task_code（唯一标识，比如create_user，方便代码中判断权限），如果一个任务只属于一个模块可以加module_id字段，否则保留module_task中间表
7. 角色-任务权限表（role_task_permissions）：替换你现有task permission表，字段id、role_id、task_id、can_view、can_create、can_edit、can_delete（四个布尔字段对应你原数组的四个权限位），添加联合唯一索引(role_id, task_id)
8. [可选] 用户-任务权限表（user_task_permissions）：如果需要支持用户跳过角色直接分配独立权限，新增该表，字段id、user_id、task_id、can_view、can_create、can_edit、can_delete，权限判断优先级高于角色权限

关联定义优化 #

Role 模型补充关联 #

class Role extends Model
{
    use HasFactory;
    
    public function modules()
    {
        return $this->belongsToMany(Module::class, 'role_modules');
    }

    // 远程关联获取角色下所有任务
    public function tasks()
    {
        return $this->hasManyThrough(Task::class, Module::class)
            ->join('role_task_permissions', 'tasks.id', '=', 'role_task_permissions.task_id')
            ->where('role_task_permissions.role_id', $this->id);
    }

    // 关联角色下所有任务权限
    public function taskPermissions()
    {
        return $this->hasMany(RoleTaskPermission::class);
    }
}

User 模型新增关联 #

class User extends Model
{
    use HasFactory;
    
    // 用户关联角色
    public function roles()
    {
        return $this->belongsToMany(Role::class, 'user_roles');
    }

    // 获取用户所有有权限的模块
    public function modules()
    {
        return $this->roles->load('modules')->pluck('modules')->flatten()->unique('id');
    }

    // 获取用户所有任务权限（叠加用户独立权限+角色权限，用户权限优先级更高）
    public function taskPermissions()
    {
        $rolePermissions = $this->roles->load('taskPermissions')->pluck('taskPermissions')->flatten();
        $userPermissions = $this->hasMany(UserTaskPermission::class)->get() ?? collect();
        return $userPermissions->merge($rolePermissions)->unique('task_id');
    }

    // 封装权限判断方法，直接在代码中调用
    public function hasPermission(string $taskCode, string $action = 'view'): bool
    {
        $task = Task::where('task_code', $taskCode)->first();
        if (!$task) return false;
        $permission = $this->taskPermissions()->where('task_id', $task->id)->first();
        return $permission?->{"can_$action"} ?? false;
    }
}

额外优化建议 #

• 任务的task_code字段尽量使用语义化的唯一值，不要依赖主键ID判断权限，后续调整数据不会影响业务代码
• 权限拆分为独立布尔字段后，可直接通过SQL查询满足对应权限的角色/用户，比数组格式灵活度高很多
• 所有中间表加联合唯一索引，既能避免重复关联数据，也能提升关联查询效率

内容的提问来源于stack exchange，提问作者joenpc npcsolution