问题

将一个Laravel 13 + Filament v3应用部署到cPanel共享主机后，/admin/login 能正确加载并完成认证，但跳转到 /admin 总是返回一个 403禁止访问 的响应。

症状

• /admin/login 正常加载
• 用户凭据被接受
• 会话成功创建
• 跳转到 /admin 返回 403禁止访问
• storage/logs/laravel.log 中没有出现错误
• canAccessPanel() 返回 true
• 用户具有 super_admin 角色（Spatie Permission + FilamentShield）
• APP_DEBUG=true 仍然显示一个普通的403页面

环境

• PHP 8.3
• Laravel 13
• Filament v3 v5
• FilamentShield
• cPanel共享主机

我尝试过的解决方法

• php artisan optimize:clear
• 重建Laravel缓存
• 清除Filament缓存
• 禁用FilamentShield
• 将所有权限分配给 super_admin 角色
• 验证 canAccessPanel() 返回 true
• 禁用Cloudflare安全规则

用户模型

use Filament\Models\Contracts\FilamentUser;
use Filament\Models\Contracts\HasAvatar;

class User extends Authenticatable implements HasAvatar
{
    public function canAccessPanel(Panel $panel): bool
    {
        return true;
    }
}

尽管 canAccessPanel() 返回 true，登录后Filament仍然返回403响应。

问题

在以下情况仍然发生时，是什么原因会导致Filament v3在成功认证后返回403响应呢：

• canAccessPanel() 返回 true
• 用户具有正确的角色和权限
• 没有记录任何异常
• 认证成功

解决方案

Solution

问题在于 FilamentUser 接口被导入，但并未被 User 模型实际实现。

不正确

class User extends Authenticatable implements HasAvatar

正确

class User extends Authenticatable implements FilamentUser, HasAvatar

可用示例

use Filament\Models\Contracts\FilamentUser;
use Filament\Models\Contracts\HasAvatar;
use Filament\Panel;
use Illuminate\Foundation\Auth\User as Authenticatable;

class User extends Authenticatable implements FilamentUser, HasAvatar
{
    public function canAccessPanel(Panel $panel): bool
    {
        return true;
    }

    public function getFilamentAvatarUrl(): ?string
    {
        return $this->avatar
            ? Storage::disk('public')->url($this->avatar)
            : null;
    }
}

解释

Filament在授予面板访问权限之前，会检查经过认证的用户是否实现了 FilamentUser 合同。

因为该接口被导入但未包含在 implements 条款中，Filament拒绝访问并返回403响应。

将 FilamentUser 添加到 User 模型后，问题立即得到解决。