需启用logredirects中间件并配置responseprepared事件监听器来追踪跳转链路:前者记录get请求的_from/to_地址,后者捕获302响应的_location_与_referer_,再通过日志分类和路径过滤减少干扰。

排查Laravel项目中用户页面跳转异常(比如登录后没进首页、点击按钮无响应却也没报错)时,需要明确每次HTTP请求的来源路径、目标路由、中间件执行顺序和重定向链路,否则仅靠浏览器F5刷新或日志里的“404”“500”无法定位真实跳转断点。
启用内置跳转日志中间件
在app/Http/Kernel.php的$middlewareGroups['web']数组开头插入中间件类:\App\Http\Middleware\LogRedirects::class。
这一步必须放在session、encrypt_cookies等依赖会话或加密的中间件之前,否则$_SESSION或解密失败会导致跳转日志记录为空或报错。
运行php artisan make:middleware LogRedirects生成该类文件。
编写跳转日志中间件逻辑
打开app/Http/Middleware/LogRedirects.php,在handle方法内写入:
if ($request->isMethod('get') && session()->has('_previous')) {
$prev = session()->get('_previous.url');
$curr = $request->fullUrl();
\Illuminate\Support\Facades\Log::info("跳转链路", ['from' => $prev, 'to' => $curr, 'user_id' => optional(auth()->user())->id]);
}
注意:Laravel自动在redirect()后写入_session._previous.url,但仅限GET请求生效;POST跳转后若未手动保留_referrer,此处将拿不到上一页地址。
如果当前请求是302重定向响应,则需监听响应事件而非请求——直接在中间件里判断response()->getStatusCode() === 302无效,因为此时响应尚未生成。
捕获重定向响应并记录
第一步:在app/Providers/EventServiceProvider.php的$listen数组中添加:
'Illuminate\Http\Events\ResponsePrepared' => [
\App\Listeners\LogRedirectResponse::class,
],
第二步:运行php artisan make:listener LogRedirectResponse --event=ResponsePrepared生成监听器。
第三步:打开app/Listeners/LogRedirectResponse.php,在handle方法中写入:
if ($event->response->getStatusCode() === 302 && $event->request->hasSession()) {
$loc = $event->response->headers->get('Location');
$referer = $event->request->headers->get('Referer', 'unknown');
Log::info('302跳转触发', ['referer' => $referer, 'location' => $loc, 'session_id' => $event->request->session()->getId()]);
}
【Referer头可能被浏览器或代理清空,不能作为唯一依据】,必须配合_session._previous.url交叉验证。
过滤高频干扰日志
方法一:在config/logging.php的stack通道里为redirect日志单独配置daily驱动,设置日志文件名前缀为laravel-redirect-。
方法二:给redirect日志加context字段'category' => 'redirect',再用logstash或grep -E "category\":\"redirect"快速筛选。
方法三:在LogRedirects中间件里加条件判断——跳过/assets/、/favicon.ico、/storage/等静态资源路径,避免每刷一次页面就记10条无效日志。











