Laravel：调用AuthenticationException::guards()报未定义方法错误求助

看起来你在 Laravel 项目的 Handler.php 里自定义未授权处理逻辑时踩了版本兼容的坑，我来帮你梳理下问题原因和解决办法：

问题根源 #

AuthenticationException 类的 guards() 方法是 Laravel 5.5 及以后版本才新增的，如果你使用的是 5.4 或更早的 Laravel 版本，这个方法根本不存在，自然会抛出「调用未定义方法」的错误。

针对性解决方案 #

情况1：你使用的是 Laravel 5.4 及更早版本

这些版本的 AuthenticationException 把守卫信息存在了一个 protected 属性 $guards 里，没有对外提供 guards() 方法。你可以通过反射来获取这个属性的值：

protected function unauthenticated($request, AuthenticationException $exception)
{
    if ($request->expectsJson()) {
        return response()->json(['message' => $exception->getMessage()], 401);
    }

    // 通过反射获取protected的$guards属性
    $reflection = new ReflectionClass($exception);
    $guardsProperty = $reflection->getProperty('guards');
    $guardsProperty->setAccessible(true);
    $guards = $guardsProperty->getValue($exception);
    
    $guard = array_get($guards, 0);

    // 你的switch逻辑...
    return redirect()->guest(route("{$guard}.login")); // 示例跳转对应守卫的登录页
}

情况2：你使用的是 Laravel 5.5+ 版本但仍报错

这种情况大概率是缓存问题，Laravel 的类缓存可能没更新，导致系统找不到新的方法。执行以下命令清除缓存即可：

php artisan clear-compiled
php artisan cache:clear

另外也检查下 Handler.php 顶部是否正确引入了 Illuminate\Auth\AuthenticationException 类，避免命名空间错误。

兼容多版本的通用写法

如果你不确定自己的 Laravel 版本，或者想让代码适配多个版本，可以用 method_exists 做判断：

protected function unauthenticated($request, AuthenticationException $exception)
{
    if ($request->expectsJson()) {
        return response()->json(['message' => $exception->getMessage()], 401);
    }

    // 兼容新旧版本的guards获取方式
    $guards = method_exists($exception, 'guards') 
        ? $exception->guards()
        : (function() use ($exception) {
            $reflection = new ReflectionClass($exception);
            $prop = $reflection->getProperty('guards');
            $prop->setAccessible(true);
            return $prop->getValue($exception);
        })();

    $guard = array_get($guards, 0);

    // 你的switch逻辑...
    return redirect()->guest(route("{$guard}.login"));
}

最后提醒 #

如果是升级 Laravel 版本后出现的问题，记得仔细核对官方升级文档里的「异常处理」部分，有些版本会对 Handler.php 的方法签名或依赖类做调整。

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