如何解决Laravel路由与中间件的重定向循环问题

问题背景 #

我设置了RedirectIfAdminExists中间件，意图在用户未以admin身份登录且访问后台专属路由时，重定向到admin登录页。但当前配置导致了重定向循环，尤其在admin登录页本身。我尝试在路由组内给admin登录路由排除该中间件，虽暂时解决了循环，但不确定这是否是最优方案。

当前中间件核心逻辑：

if (!Auth::guard('admin')->check() && !$request->routeIs('admin.login')) {
    return redirect()->route('admin.login');
}

当前路由配置（存在重复定义路由的问题）：

Route::get('/admin/login', [AdminController::class, 'showLoginForm'])->name('admin.login');
Route::post('/admin/login', [AdminController::class, 'login'])->name('admin.login.post');

Route::middleware([RedirectIfAdminExists::class])->group(function () {
    Route::get('/admin/login', [AdminController::class, 'showLoginForm'])->name('admin.login')->withoutMiddleware([RedirectIfAdminExists::class]);
    Route::get('/admin', [AdminController::class, 'index'])->name('admin.index');
    // 其他后台路由...
});

更优解决方案 #

方案1：优化中间件逻辑，排除所有登录相关路由 #

直接在中间件里排除登录页面的GET请求和登录提交的POST请求，避免路由重复定义：

修改RedirectIfAdminExists中间件的handle方法：

public function handle(Request $request, Closure $next)
{
    // 排除登录页和登录提交路由
    $exceptRoutes = ['admin.login', 'admin.login.post'];
    
    if (!Auth::guard('admin')->check() && !in_array($request->route()->getName(), $exceptRoutes)) {
        return redirect()->route('admin.login');
    }

    return $next($request);
}

路由配置简化为：

// 登录相关路由无需中间件
Route::get('/admin/login', [AdminController::class, 'showLoginForm'])->name('admin.login');
Route::post('/admin/login', [AdminController::class, 'login'])->name('admin.login.post');

// 后台其他路由统一应用中间件
Route::middleware([RedirectIfAdminExists::class])->group(function () {
    Route::get('/admin', [AdminController::class, 'index'])->name('admin.index');
    Route::get('/admin/create', [AdminController::class, 'create'])->name('admin.create');
    Route::post('/admin', [AdminController::class, 'store'])->name('admin.store');
    Route::get('/admin/{admin}', [AdminController::class, 'show'])->name('admin.show');
    Route::get('/admin/{admin}/edit', [AdminController::class, 'edit'])->name('admin.edit');
    Route::put('/admin/{admin}', [AdminController::class, 'update'])->name('admin.update');
    Route::delete('/admin/{admin}', [AdminController::class, 'destroy'])->name('admin.destroy');
});

方案2：拆分路由组，清晰区分公开与需验证路由 #

这是最直观的方式，把不需要验证的登录路由单独放在中间件组外，需要验证的后台路由放在组内，完全避免路由重复：

// 公开的登录路由，无需验证
Route::prefix('admin')->group(function () {
    Route::get('/login', [AdminController::class, 'showLoginForm'])->name('admin.login');
    Route::post('/login', [AdminController::class, 'login'])->name('admin.login.post');
});

// 需要admin身份验证的后台路由
Route::prefix('admin')->middleware([RedirectIfAdminExists::class])->group(function () {
    Route::get('/', [AdminController::class, 'index'])->name('admin.index');
    Route::get('/create', [AdminController::class, 'create'])->name('admin.create');
    Route::post('/', [AdminController::class, 'store'])->name('admin.store');
    Route::get('/{admin}', [AdminController::class, 'show'])->name('admin.show');
    Route::get('/{admin}/edit', [AdminController::class, 'edit'])->name('admin.edit');
    Route::put('/{admin}', [AdminController::class, 'update'])->name('admin.update');
    Route::delete('/{admin}', [AdminController::class, 'destroy'])->name('admin.destroy');
});

方案3：使用Laravel自带的Auth中间件（推荐） #

Laravel自带了针对多guard的身份验证中间件，无需自定义中间件，直接使用auth:admin即可：

路由配置：

// 公开登录路由
Route::get('/admin/login', [AdminController::class, 'showLoginForm'])->name('admin.login');
Route::post('/admin/login', [AdminController::class, 'login'])->name('admin.login.post');

// 后台路由使用自带auth中间件指定admin guard
Route::middleware('auth:admin')->group(function () {
    Route::get('/admin', [AdminController::class, 'index'])->name('admin.index');
    // 其他后台路由...
});

同时，确保在config/auth.php中正确配置admin guard：

'guards' => [
    'admin' => [
        'driver' => 'session',
        'provider' => 'admins',
    ],
],

'providers' => [
    'admins' => [
        'driver' => 'eloquent',
        'model' => App\Models\Admin::class,
    ],
],

为什么当前方案不够优 #

当前路由配置重复定义了admin.login路由，虽然通过withoutMiddleware临时规避了循环，但会导致路由注册冗余，且逻辑不够清晰。上面的方案都能避免这个问题，同时让代码结构更易维护。

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