Laravel多租户场景下用户权限无法获取问题排查

• 给Permission模型添加租户全局作用域
  多租户场景下，权限查询需自动过滤当前租户的company_id，否则会跨租户查询导致无匹配结果。在Permission模型中添加全局作用域：

  protected static function booted()
  {
      static::addGlobalScope('company', function ($query) {
          if (auth()->check() && auth()->user()->company_id) {
              $query->where('company_id', auth()->user()->company_id);
          }
      });
  }
  

  同理确保Role模型已添加该作用域（你能获取到角色，大概率已配置，但需确认）。

• 修正角色与权限的关联关系
  多租户下角色与权限的关联需绑定租户ID，避免跨租户关联：

  • 若role_permission关联表已添加company_id字段，在Role模型中调整关联：

    public function permissions()
    {
        return $this->belongsToMany(Permission::class)
            ->wherePivot('company_id', $this->company_id);
    }
    

  • 若关联表未加company_id，至少确保权限查询时匹配角色的租户ID：

    public function permissions()
    {
        return $this->belongsToMany(Permission::class)
            ->where('permissions.company_id', $this->company_id);
    }
    

  同时在Permission模型中对应调整roles关联逻辑。

• 清除权限缓存
  Laravel权限默认启用缓存，新增/修改权限后需重置缓存：

  php artisan cache:clear
  php artisan permission:cache-reset
  

• 验证用户与角色的关联约束
  确保User模型的roles关联仅返回当前租户的角色：

  public function roles()
  {
      return $this->belongsToMany(Role::class)
          ->where('roles.company_id', $this->company_id);
  }
  

• 手动排查数据库关联数据
  通过Tinker直接验证关联是否存在：

  $user = User::find(你的用户ID);
  $role = $user->roles->first();
  dd($role->permissions);
  

  若结果为空，检查role_permission表是否存在该角色与权限的关联记录，且company_id与角色、权限的company_id完全一致。

• 自定义权限认证逻辑（针对Spatie权限包）
  如果你使用的是spatie/laravel-permission，可在AuthServiceProvider的boot方法中手动指定权限过滤规则：

  Gate::before(function ($user, $ability) {
      // 超级管理员可跳过租户检查（按需添加）
      if ($user->hasRole('super-admin')) {
          return true;
      }
      // 仅校验当前租户下的权限
      return $user->getAllPermissions()
          ->where('company_id', $user->company_id)
          ->contains('name', $ability);
  });
  

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