You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Laravel:能否为每个请求记录完整堆栈跟踪?

Laravel 记录每个请求的完整堆栈跟踪

原生实现方案

Laravel 没有默认提供记录每个请求完整堆栈跟踪的功能,但可以通过自定义中间件快速实现:

  1. 生成自定义中间件
    执行Artisan命令创建中间件文件:

    php artisan make:middleware RecordRequestStacktrace
    
  2. 编写堆栈跟踪记录逻辑
    打开app/Http/Middleware/RecordRequestStacktrace.php,修改handle方法:

    public function handle(Request $request, Closure $next)
    {
        // 捕获当前堆栈跟踪,DEBUG_BACKTRACE_IGNORE_ARGS用于忽略函数参数,减少日志体积
        $stackTrace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS);
        
        // 将堆栈跟踪写入日志,附带请求基本信息
        Log::info('Request Full Stacktrace', [
            'request_url' => $request->fullUrl(),
            'request_method' => $request->method(),
            'stacktrace' => $stackTrace
        ]);
        
        return $next($request);
    }
    

    若需要保留函数参数,移除DEBUG_BACKTRACE_IGNORE_ARGS常量即可。

  3. 注册中间件
    在app/Http/Kernel.php中,将中间件添加到目标中间件组(如web、api或全局中间件):

    protected $middlewareGroups = [
        'web' => [
            // ...其他已存在的中间件
            \App\Http\Middleware\RecordRequestStacktrace::class,
        ],
    ];
    

第三方包方案

如果不想自定义开发,可以选择成熟的第三方包:

  • laravel-request-logger:专门用于记录请求细节,支持配置开启堆栈跟踪记录,安装后只需调整配置文件即可启用相关功能。
  • spatie/laravel-activitylog:虽主打活动日志,但可通过扩展配置实现请求堆栈跟踪的记录,适合需要同时追踪用户行为与请求上下文的场景。

Laravel Telescope 补充说明

Telescope 默认不记录完整请求堆栈跟踪,但可通过自定义 Watcher 扩展其功能:
需要编写自定义 Watcher 类,在请求生命周期节点捕获堆栈跟踪并存储到 Telescope 的数据存储中,但这种方式需要对 Telescope 底层逻辑有一定了解,复杂度高于自定义中间件。

内容的提问来源于stack exchange,提问作者Hasan Hafiz Pasha

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.20 23:45:39