Laravel中JWT中间件无法识别已存在的浏览器Cookie问题

针对你遇到的「浏览器可见JWT Cookie但中间件无法识别」问题，可从以下几个方向逐一排查：

1. 检查Cookie的加密状态 #

Laravel默认会对所有Cookie进行加密，如果你的user Cookie是直接通过原生方式设置（而非Laravel的cookie()助手或响应方法），或者没有在加密排除列表中配置，那么$request->cookie('user')拿到的是加密后的字符串，JWTAuth无法解析。

解决步骤：

• 在config/app.php的encrypt配置的except数组中添加user，排除该Cookie的加密：

'encrypt' => [
    'except' => [
        'user', // 添加这一行，排除user Cookie的加密
    ],
],

• 确保登录成功后使用Laravel官方方法设置Cookie：

return redirect()->route('user.home')
    ->cookie('user', $token, 1440, '/', null, env('SESSION_SECURE_COOKIE'), true, false);

2. 验证Cookie的路径与域名配置 #

浏览器只会向匹配Cookie路径和域名的请求发送Cookie，如果你的user Cookie路径设置为/login或其他子路径，访问/user/home时浏览器不会携带该Cookie。

检查与修复：

• 打开浏览器开发者工具「Application」标签，查看user Cookie的Path是否为/（根路径），Domain是否和当前网站域名一致。
• 如果路径错误，设置Cookie时指定正确的根路径：

->cookie('user', $token, 1440, '/'); // 第四个参数为Cookie生效路径

3. 检查JWT Token的有效性与用户角色 #

即使Cookie存在，也可能因为Token无效或用户角色不匹配导致中间件跳转：

• 临时在中间件中添加日志，输出拿到的$token值，手动解析Token（按照JWT三段式结构拆分查看payload和签名），确认是否过期、签名是否正确，以及payload中是否包含正确的用户信息。
• 检查数据库中用户的role字段值是否为大写的USER（中间件中判断规则为$user->role === 'USER'，如果数据库中是小写user则不匹配）。
• 如果Token过期，可在config/jwt.php中修改ttl配置调整Token有效期。

4. 调试中间件执行流程 #

在中间件中添加更详细的日志，定位具体失败环节：

public function handle($request, Closure $next)
{
    Log::info('所有请求Cookie:', $request->cookies->all()); // 输出所有Cookie，确认是否能拿到user
    
    if ($request->hasCookie('user')) {
        $token = $request->cookie('user');
        Log::info('获取到的Token:', ['token' => $token]);

        try {
            $user = JWTAuth::setToken($token)->authenticate();
            Log::info('认证成功的用户信息:', ['user' => $user->toArray()]);

            if ($user && $user->role === 'USER') {
                Log::info('用户为合法普通用户');
                return $next($request);
            } else {
                Log::warning('用户角色不符合要求:', ['role' => $user->role ?? '未获取到角色']);
            }
        } catch (JWTException $e) {
            Log::error('JWT认证错误:', ['message' => $e->getMessage()]);
            return redirect()->route('login');
        }
    }

    Log::warning('User cookie not found or user is not a regular user.');
    return redirect()->route('login');
}

通过日志可以明确是「Cookie未被请求携带」「Token无效」还是「角色不匹配」导致的跳转。

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