Laravel中tokenCan()方法未定义问题求助

问题分析 #

你在中间件中调用auth()->user()->tokenCan('role:customer')时出现方法未定义，核心原因是当前认证的用户实例未携带Passport的HasApiTokens trait能力，大概率是守卫配置错误或Sanctum与Passport的使用混淆导致。

解决方案 #

1. 确认API守卫使用Passport驱动

tokenCan是Laravel Passport专属方法，若你的API守卫配置为Sanctum，用户实例将不具备该方法。修改config/auth.php中的API守卫配置：

'guards' => [
    'api' => [
        'driver' => 'passport', // 替换为passport，而非sanctum
        'provider' => 'users',
    ],
],

2. 确保User模型正确引入Passport的HasApiTokens

检查你的User模型，确认引入的是Passport的trait（而非Sanctum的）：

// app/Models/User.php
use Illuminate\Foundation\Auth\User as Authenticatable;
use Laravel\Passport\HasApiTokens;
use Illuminate\Notifications\Notifiable;
use Illuminate\Database\Eloquent\Factories\HasFactory;

class User extends Authenticatable
{
    use HasApiTokens, HasFactory, Notifiable;

    // ... 其他模型代码
}

3. 若使用Sanctum，替换权限判断逻辑

如果你实际想用Sanctum做认证，Sanctum本身没有tokenCan方法，需通过用户模型的字段（如role）直接判断：

// 修改中间件的handle方法
public function handle($request, Closure $next)
{
    if (auth()->user()->role === 'customer') {
        return $next($request);
    }

    return response()->json('Not Authorized', 401);
}

4. 清除配置缓存

修改配置后执行以下命令生效：

php artisan config:clear
php artisan cache:clear

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