Laravel 9 路由控制器组绑定中间件不生效问题排查

以下是针对未认证用户未被重定向到指定登录页问题的逐一排查点：

1. 检查中间件核心逻辑 #

确保中间件正确指定host guard并返回重定向响应，避免遗漏关键代码：

<?php

namespace App\Http\Middleware;

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

class UserIsAuthenticated
{
    public function handle($request, Closure $next)
    {
        // 必须明确使用host guard校验认证状态
        if (!Auth::guard('host')->check()) {
            // 重定向到host登录路由，确保路由名称完全匹配
            return redirect()->route('host.login');
        }

        return $next($request);
    }
}

• 注意：如果未加return，重定向逻辑不会生效；务必确认host guard名称与配置文件一致。

2. 确认中间件在Kernel中正确注册 #

打开app/Http/Kernel.php，检查$routeMiddleware数组里是否正确注册了你的中间件：

protected $routeMiddleware = [
    // ... 其他默认中间件
    'host.auth' => \App\Http\Middleware\UserIsAuthenticated::class, // 确保命名空间和类名无错误
];

• 中间件别名（这里是host.auth）需和路由中使用的名称完全一致，大小写敏感。

3. 检查路由是否正确应用中间件 #

确保HostController的所有路由都绑定了host.auth中间件，且路由处于web中间件组内（因为Auth依赖session，web组包含session、csrf等必要中间件）：

// 正确写法：将host路由放在web组内，并应用host.auth中间件
Route::middleware(['web', 'host.auth'])->group(function () {
    Route::get('/host/dashboard', [HostController::class, 'dashboard']);
    Route::resource('/host/listings', HostController::class);
    // HostController的其他路由
});

• 避免将路由放在web组外，否则session无法正常工作，导致认证状态无法持久化。

4. 验证Host Guard配置正确性 #

打开config/auth.php，确认host guard的配置无误：

'guards' => [
    // ... web guard配置
    'host' => [
        'driver' => 'session', // 需用session驱动才能维持登录状态
        'provider' => 'hosts', // 对应下方的providers配置
    ],
],

'providers' => [
    // ... users provider配置
    'hosts' => [
        'driver' => 'eloquent',
        'model' => App\Models\Host::class, // 确保Host模型存在且实现Authenticatable接口
    ],
],

• Host模型必须继承Illuminate\Foundation\Auth\User或实现Illuminate\Contracts\Auth\Authenticatable接口，否则无法正常认证。

5. 确认登录路由名称匹配 #

检查host.login路由是否正确定义，名称拼写完全一致：

// 示例：Host登录页路由
Route::get('/host/login', [HostAuthController::class, 'showLoginForm'])->name('host.login');

• 如果路由名称拼写错误（比如写成host_login或Host.login），重定向会失败，可能直接返回404或无反应。

额外排查点 #

• 检查session驱动：确保config/session.php中driver不是array（array驱动仅用于测试，重启或刷新后会丢失session），建议使用file或database。
• 清除路由缓存：运行php artisan route:clear，避免旧的路由配置缓存导致中间件未生效。

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