需通过事件监听机制开启DB查询日志功能：一、用DB::listen全局监听；二、启用DB::enableQueryLog手动提取；三、创建专用服务提供者分离逻辑；四、基于QueryExecuted事件监听；五、条件性记录慢查询。
如果您在开发 Laravel 应用时需要实时捕获数据库查询语句、绑定参数及执行耗时，以辅助调试或性能分析，则需通过事件监听机制开启 DB 查询日志功能。以下是具体实施步骤：
一、使用 DB::listen 全局监听查询
DB::listen 是 Laravel 提供的轻量级查询监听接口，它会在每次 Query Builder 或 DB 门面发起查询后立即触发回调，适用于开发阶段快速定位慢查或意外 SQL。该方法注册后对当前请求生命周期内所有符合条件的查询生效，但不捕获原生 PDO 查询或缓存命中场景。
1、在 app/Providers/AppServiceProvider.php 文件的 boot() 方法中引入 DB 门面：use Illuminate\Support\Facades\DB;
2、添加监听回调代码，确保仅在本地环境启用：if (app()->environment('local')) { DB::listen(function ($query) { \Log::debug('SQL Executed', ['sql' => $query->sql, 'bindings' => $query->bindings, 'time' => $query->time]); }); }
3、执行任意含数据库操作的 HTTP 请求，查看 storage/logs/laravel.log 中是否输出带时间戳的 SQL 日志条目。
二、启用查询日志并手动提取上一条 SQL
DB::enableQueryLog() 启用后，Laravel 会为当前数据库连接实例维护一个内存中的查询记录数组，适合在控制器或测试中按需获取最近执行的语句。注意该日志不自动包含真实参数值，且仅对当前连接有效，读写分离环境下需指定连接名。
1、在目标逻辑开始前调用：DB::enableQueryLog();
2、执行一次数据库操作，例如：User::where('id', 1)->first();
3、获取全部日志并提取最后一条：$queries = DB::getQueryLog(); $last = end($queries); \Log::debug('Last Query', ['sql' => $last['query'], 'bindings' => $last['bindings']]);
4、如需拼出完整可执行 SQL，须手动替换 ? 占位符，不可直接依赖 toSql() 返回结果。
三、创建专用服务提供者分离监听逻辑
将 DB 监听逻辑从 AppServiceProvider 中解耦，有利于团队协作与后期维护，同时避免 boot() 方法膨胀。此方式通过 Laravel 的服务提供者注册机制，在应用启动早期统一挂载监听器，保障监听覆盖完整性。
1、运行 Artisan 命令生成新提供者：php artisan make:provider DatabaseQueryServiceProvider
2、编辑生成文件，在 boot() 方法中写入与第一种方式相同的 DB::listen 回调逻辑。
3、打开 config/app.php，将新提供者加入 providers 数组：'App\Providers\DatabaseQueryServiceProvider'::class
4、清除配置缓存使变更生效：php artisan config:clear
四、基于事件服务提供者注册数据库事件监听器
Laravel 内置了 Illuminate\Database\Events\QueryExecuted 事件，它比 DB::listen 更底层，能捕获更完整的上下文信息（如连接名称、是否为读操作），且支持在 EventServiceProvider 中集中管理，便于扩展事务相关监听逻辑。
1、在 app/Providers/EventServiceProvider.php 的 $listen 属性中添加映射：'Illuminate\Database\Events\QueryExecuted' => ['App\Listeners\LogQueryExecution']
2、运行 php artisan event:generate 自动创建监听器类。
3、在生成的 LogQueryExecution.php 中编写日志逻辑，使用 $event->sql、$event->bindings 和 $event->time 字段。
4、确保监听器构造函数不依赖 DB 实例或连接对象，事件对象本身已携带全部必要信息。
五、条件性记录慢查询以降低日志开销
在调试过程中若发现日志量过大影响响应速度或磁盘空间，可通过设置执行时间阈值实现精准捕获，仅记录超过预设毫秒数的查询，兼顾可观测性与性能稳定性。
1、修改 DB::listen 回调，增加判断条件：if ($query->time > 200) { \Log::warning('Slow Query Detected', [...]); }
2、可进一步结合连接类型过滤，排除健康检查等高频低耗查询：if ($query->connectionName === 'mysql' && $query->time > 200)
3、将日志写入独立文件路径，避免污染主日志：file_put_contents(storage_path('logs/slow_queries.log'), ..., FILE_APPEND)
4、确认 storage/logs/ 目录具有写权限，否则日志将静默失败。
