Laravel带认证AJAX请求会话过期后提示/重定向问题咨询

这个场景我太熟悉了！很多项目都会遇到这种用户忘记登出、会话过期后还在操作的情况，在Laravel里其实可以通过后端中间件拦截+前端全局监听的组合来完美解决，下面给你一步步拆解实现：

后端处理（Laravel端） #

我们需要自定义一个中间件，专门处理AJAX请求的认证校验，当会话失效时返回标准化的错误响应：

1. 创建自定义认证中间件
   在终端执行命令生成中间件：

   php artisan make:middleware CheckAjaxAuth
   

2. 编写中间件逻辑
   打开生成的app/Http/Middleware/CheckAjaxAuth.php，修改handle方法：

   <?php
   
   namespace App\Http\Middleware;
   
   use Closure;
   use Illuminate\Support\Facades\Auth;
   
   class CheckAjaxAuth
   {
       public function handle(\Illuminate\Http\Request $request, Closure $next)
       {
           // 判断用户是否已认证
           if (!Auth::check()) {
               // 如果是AJAX/JSON请求，返回401状态码的JSON响应
               if ($request->ajax() || $request->wantsJson()) {
                   return response()->json([
                       'success' => false,
                       'message' => '您的会话已过期，请重新登录'
                   ], 401);
               }
               // 非AJAX请求直接跳转登录页
               return redirect()->route('login');
           }
   
           return $next($request);
       }
   }
   

3. 注册中间件
   打开app/Http/Kernel.php，在$routeMiddleware数组中添加自定义中间件的别名：

   protected $routeMiddleware = [
       // ... 其他默认中间件
       'auth.ajax' => \App\Http\Middleware\CheckAjaxAuth::class,
   ];
   

4. 给需要认证的AJAX路由挂载中间件
   在路由文件（比如routes/web.php或routes/api.php）中，给AJAX接口加上这个中间件：

   Route::group(['middleware' => ['auth.ajax']], function () {
       // 你的AJAX接口示例
       Route::post('/api/user/submit-task', [TaskController::class, 'submit']);
       Route::get('/api/user/get-data', [DataController::class, 'fetch']);
   });
   

前端处理（JS端） #

接下来需要在前端全局监听AJAX请求的错误，捕获到后端返回的401状态码时，提示用户并跳转登录页：

如果你用jQuery： #

在页面的全局JS文件中添加如下代码：

// 全局监听AJAX错误
$(document).ajaxError(function(event, xhr, settings, thrownError) {
    // 捕获401未授权状态码
    if (xhr.status === 401) {
        // 提示用户会话过期
        alert('您的登录会话已过期，请重新登录后操作');
        // 跳转到登录页
        window.location.href = '/login';
    }
});

如果你用Axios： #

在Axios初始化的地方添加响应拦截器：

// Axios响应拦截器
axios.interceptors.response.use(
    response => response, // 正常响应直接返回
    error => {
        // 捕获401未授权状态码
        if (error.response?.status === 401) {
            alert('您的登录会话已过期，请重新登录后操作');
            window.location.href = '/login';
        }
        return Promise.reject(error);
    }
);

这样一来，不管用户隔了多久回到页面操作，只要会话已经失效，AJAX请求就会触发后端的401响应，前端立刻提示用户并跳转到登录页，完全解决了用户不知情的问题。

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