Debugbar未显示或Queries面板为空需按五步排查：一查APP_DEBUG=true且APP_ENV=local；二清缓存并验证中间件注入；三发布并修正config/debugbar.php启用queries collector；四Laravel 10+须手动注册服务提供者；五确保查询经Query Builder且启用DB::enableQueryLog()。
如果您在 Laravel 项目中需要实时监控 SQL 查询、分析执行耗时与调用栈，但 Debugbar 工具栏未显示或 Queries 面板为空，则可能是配置未生效、环境不匹配或查询未被日志捕获。以下是多种可立即验证与执行的操作方法：
一、确认基础启用条件并强制激活
Debugbar 仅在 APP_DEBUG=true 且非 CLI 环境下自动注入，同时依赖中间件正确执行。若工具栏完全不出现，需优先验证运行上下文与核心开关。
1、检查 .env 文件中是否明确设置 APP_DEBUG=true 且 APP_ENV=local；
2、运行 php artisan config:clear 清除配置缓存；
3、在浏览器访问页面后，打开 DevTools → Network → 任一 HTML 请求 → 查看 Response Headers 中是否存在 X-Debugbar-Data；若不存在，说明中间件未触发；
4、打开 app/Http/Kernel.php，确认 $middlewareGroups['web'] 中已包含 \Barryvdh\Debugbar\Middleware\DebugbarEnabled::class，且位置在 StartSession 和 VerifyCsrfToken 之后。
二、手动发布并修正配置文件
默认配置未发布时，Debugbar 使用内置硬编码设置，可能导致 queries collector 被禁用或 enabled 判断逻辑失效。必须显式生成并修改 config/debugbar.php。
1、执行命令 php artisan vendor:publish --provider="Barryvdh\Debugbar\ServiceProvider"；
2、打开 config/debugbar.php，将 'enabled' => env('DEBUGBAR_ENABLED', null) 改为 'enabled' => env('APP_DEBUG', false)；
3、确保 'collectors' => ['queries' => true] 未被注释或覆盖；
4、检查 'queries' => ['enabled' => true] 子项是否存在且值为 true。
三、适配 Laravel 10+ 版本的手动服务提供者注册
Laravel 10 及以上版本已移除自动发现机制，若未显式注册服务提供者，Debugbar 将完全不加载，即使 APP_DEBUG=true 也无效。
1、打开 config/app.php；
2、在 'providers' 数组末尾添加：Barryvdh\Debugbar\ServiceProvider::class；
3、如需使用门面语法（如 Debugbar::info()），还需在 'aliases' 数组中添加：'Debugbar' => Barryvdh\Debugbar\Facade::class；
4、若项目使用 Laravel Octane，需额外在 config/debugbar.php 的 'options' 中设置 'inject' => false，并在响应中手动注入工具栏。
四、修复 Queries 面板为空的问题
SQL 查询未出现在面板中，并非安装失败，而是因查询未进入 Laravel 日志通道。常见原因包括绕过 Query Builder、未启用日志、或 collector 被禁用。
1、确认所有数据库操作均通过 DB::table()、DB::select() 或 Eloquent 执行，避免直接调用 DB::getPdo()->query()；
2、在查询前手动启用日志：DB::enableQueryLog()（部分连接需配合 DB::connection()->enableQueryLog()）；
3、检查 config/debugbar.php 中 'collectors' => ['queries' => false] 是否被设为 false，或存在 'queries' => ['enabled' => false] 覆盖；
4、确保查询发生在 HTTP 请求生命周期内，而非 php artisan tinker、队列任务或命令行脚本中。
五、启用慢查询高亮与 EXPLAIN 分析
默认 Queries 面板仅显示原始 SQL 和参数，无法识别性能问题。需主动开启 explain、backtrace 与 duration_background 功能。
1、打开 config/debugbar.php，定位 'queries' 配置块；
2、将其替换为以下结构：'queries'=> ['enabled'=> true, 'explain'=> ['enabled'=> true, 'types'=> ['SELECT']], 'backtrace'=> true, 'timeline'=> true, 'duration_background'=> true]；
3、保存后刷新页面，耗时超过 100ms 的查询将自动标红，SELECT 语句右侧出现 Run EXPLAIN 按钮；
4、点击该按钮即可查看 MySQL 执行计划，辅助索引优化。
