Laravel/Filament多租户下用户角色权限的数据库设计优化问询

当前方案分析 #

你现有的数据库设计（unit_user中间表关联user_id/unit_id/role_id，配合独立roles表）逻辑合理，符合租户级角色的关联需求，但在代码可维护性、空值安全和性能上还有优化空间。

具体优化方案 #

1. 定义中间表模型（Pivot Model）

Laravel支持为多对多中间表创建独立模型，能让关联操作更清晰，避免每次查询都手动加载pivot.role：

创建app/Models/UnitUser.php：

namespace App\Models;

use Illuminate\Database\Eloquent\Relations\Pivot;

class UnitUser extends Pivot
{
    // 定义与Role的关联
    public function role()
    {
        return $this->belongsTo(Role::class);
    }
}

在User模型的units关联中指定使用该中间表模型：

public function units()
{
    return $this->belongsToMany(Unit::class)
        ->using(UnitUser::class)
        ->withPivot('role_id');
}

2. 优化currentUnitRole方法，增加空值安全

原方法在用户无当前租户关联时会抛出空指针异常，同时可简化查询逻辑：

public function currentUnitRole()
{
    $tenant = Filament::getTenant();
    if (!$tenant) {
        return null; // 也可根据业务需求抛出自定义异常
    }

    // 利用关联直接获取，自动加载pivot的role关联
    return $this->units()
        ->where('units.id', $tenant->id)
        ->first()?->pivot?->role;
}

更高效的方式是直接查询中间表（需在User模型中新增关联）：

// User模型中新增关联
public function unitUsers()
{
    return $this->hasMany(UnitUser::class);
}

// 优化后的角色获取方法
public function currentUnitRole()
{
    $tenantId = Filament::getTenant()?->id;
    if (!$tenantId) {
        return null;
    }

    return $this->unitUsers()
        ->where('unit_id', $tenantId)
        ->first()?->role;
}

3. 角色默认值的工程化处理

避免硬编码角色名称，在Role模型中定义常量：

class Role extends Model
{
    const ROLE_OWNER = 'owner';
    const ROLE_READER = 'reader';
}

在创建租户和邀请用户的逻辑中使用常量：

// 用户创建Unit时自动关联owner角色
$unit = Unit::create($data);
$unit->users()->attach(auth()->id(), [
    'role_id' => Role::where('name', Role::ROLE_OWNER)->value('id')
]);

// 邀请用户加入Unit时默认关联reader角色
$unit->users()->attach($invitedUserId, [
    'role_id' => Role::where('name', Role::ROLE_READER)->value('id')
]);

4. 性能优化：缓存角色信息

如果currentUnitRole被频繁调用，可添加缓存减少数据库查询：

public function currentUnitRole()
{
    $tenantId = Filament::getTenant()?->id;
    if (!$tenantId) {
        return null;
    }

    $cacheKey = "user_{$this->id}_unit_{$tenantId}_role";
    return cache()->remember($cacheKey, 3600, function () use ($tenantId) {
        return $this->unitUsers()
            ->where('unit_id', $tenantId)
            ->first()?->role;
    });
}

注意：当用户角色变更时，需要手动清除对应缓存。

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