Laravel如何在同一路由/控制器中校验多Guard用户身份

我来帮你搞定Laravel多Guard在共用路由/控制器里的认证校验问题，这在多角色用户系统里太常见了。结合你给出的auth.php配置（看起来你还有一个Guard没写完，比如可能是admin这类？我先按多Guard场景给你演示），下面是几个实用的解决方案：

这种方式最灵活，适合全局或者批量路由使用，能统一处理所有Guard的认证检查。

1. 创建中间件 #

运行Artisan命令生成中间件：

php artisan make:middleware CheckAnyGuard

然后打开app/Http/Middleware/CheckAnyGuard.php，修改handle方法：

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Support\Facades\Auth;

class CheckAnyGuard
{
    public function handle($request, Closure $next)
    {
        // 定义需要检查的所有Guard（从你的auth.php配置里取实际名称）
        $guards = ['web', 'api', 'admin'];
        
        foreach ($guards as $guard) {
            if (Auth::guard($guard)->check()) {
                // 将当前登录的Guard和用户绑定到请求上，方便后续控制器调用
                $request->attributes->set('auth_guard', $guard);
                $request->attributes->set('auth_user', Auth::guard($guard)->user());
                return $next($request);
            }
        }

        // 所有Guard都未登录时的处理：网页路由跳登录页，API路由返回401
        return redirect()->route('login');
        // API场景替换为：return response()->json(['message' => 'Unauthorized'], 401);
    }
}

2. 注册中间件 #

打开app/Http/Kernel.php，在$routeMiddleware数组里添加自定义中间件的映射：

protected $routeMiddleware = [
    // ... 其他原有中间件
    'auth.any' => \App\Http\Middleware\CheckAnyGuard::class,
];

3. 在路由中使用 #

给需要共用的路由组绑定这个中间件即可：

// 共用路由组
Route::middleware('auth.any')->group(function () {
    Route::get('/dashboard', [DashboardController::class, 'index']);
    Route::post('/profile/update', [ProfileController::class, 'update']);
    // 其他共用路由...
});

在控制器里就能直接获取当前的Guard和用户：

public function index(Request $request)
{
    $currentGuard = $request->get('auth_guard');
    $currentUser = $request->get('auth_user');

    // 根据不同Guard做差异化逻辑
    switch ($currentGuard) {
        case 'web':
            // 处理普通网页用户逻辑
            break;
        case 'api':
            // 处理API接口用户逻辑
            break;
        case 'admin':
            // 处理管理员用户逻辑
            break;
    }

    return view('dashboard', compact('currentUser', 'currentGuard'));
}

如果只是少数几个控制器需要处理多Guard，也可以直接在控制器的构造方法或者具体方法里做校验：

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;

class DashboardController extends Controller
{
    public function index(Request $request)
    {
        $guards = ['web', 'api', 'admin'];
        $currentUser = null;
        $currentGuard = null;

        foreach ($guards as $guard) {
            if (Auth::guard($guard)->check()) {
                $currentUser = Auth::guard($guard)->user();
                $currentGuard = $guard;
                break;
            }
        }

        // 无登录用户时的跳转/错误返回
        if (!$currentUser) {
            return redirect()->route('login');
        }

        // 后续根据Guard编写业务逻辑
        // ...
    }
}

如果你想在全局快速获取当前有效的Guard和用户，可以自定义一个辅助函数或者扩展Auth facade：

比如在app/Helpers.php里添加辅助函数（记得先在composer.json的autoload里配置这个文件，然后执行composer dump-autoload）：

if (!function_exists('current_auth')) {
    function current_auth()
    {
        $guards = array_keys(config('auth.guards'));
        foreach ($guards as $guard) {
            if (Auth::guard($guard)->check()) {
                return [
                    'guard' => $guard,
                    'user' => Auth::guard($guard)->user()
                ];
            }
        }
        return null;
    }
}

然后在任意控制器或视图里就能直接调用：

$auth = current_auth();
if ($auth) {
    $currentGuard = $auth['guard'];
    $currentUser = $auth['user'];
} else {
    // 未登录处理逻辑
}

这些方案都能完美解决你在共用路由/控制器里校验多Guard的需求，你可以根据自己的业务场景选最适合的~

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