可通过事件系统监听 Laravel 数据库查询，首先使用 DB::listen 在 AppServiceProvider 中捕获所有 SQL 执行信息并写入日志文件，为保持结构清晰可创建独立的 DatabaseQueryServiceProvider 并注册到配置中，生产环境应添加执行时间条件（如超过 100ms）以减少日志量，同时推荐结合 Laravel Telescope 实现可视化监控，通过安装包、发布资源及迁移后访问 /telescope 查看详细查询数据。
如果您在开发 Laravel 应用时需要追踪数据库查询行为，例如记录慢查询、调试 SQL 执行或监控特定模型的查询操作，可以通过事件系统来捕获数据库查询的执行过程。以下是实现数据库查询事件监听的具体方法。
本文运行环境：MacBook Pro，macOS Sonoma
一、使用 DB::listen 监听所有查询
该方法可以全局监听应用程序中所有执行的 SQL 查询语句，适用于调试和性能分析。通过注册一个监听器，可以在每次查询执行后获取 SQL、绑定参数和执行时间。
1、打开 AppServiceProvider.php 文件，在 boot 方法中添加 DB::listen 回调。
2、引入 DB 门面：use Illuminate\Support\Facades\DB;。
3、在 boot 方法内添加如下代码块：
DB::listen(function ($query) {
file_put_contents(storage_path('logs/sql.log'),
"Time: {$query->time}ms | SQL: {$query->sql} | Bindings: ".json_encode($query->bindings)."\n",
FILE_APPEND);
});
4、确保 storage/logs/ 目录存在且可写，否则日志将无法生成。
二、基于事件服务提供者分离监听逻辑
为了保持代码结构清晰，建议将数据库查询监听逻辑独立到专门的服务提供者中，避免 AppServiceProvider 过于臃肿。
1、使用 Artisan 命令创建新的服务提供者：php artisan make:provider DatabaseQueryServiceProvider。
2、在新创建的 DatabaseQueryServiceProvider.php 中，于 boot 方法内编写与 DB::listen 相同的监听逻辑。
3、将该服务提供者注册到 config/app.php 的 providers 数组中：'providers' => [... App\Providers\DatabaseQueryServiceProvider::class]。
4、重新加载配置缓存：php artisan config:clear，使注册生效。
三、条件性记录查询以减少日志量
在生产环境中直接记录所有查询会导致日志文件迅速膨胀，因此可通过设置阈值仅记录执行时间较长的查询。
1、修改 listen 回调中的判断逻辑，加入执行时间过滤条件。
2、示例代码如下：
DB::listen(function ($query) {
if ($query->time > 100) { // 仅记录超过100毫秒的查询
file_put_contents(storage_path('logs/slow_queries.log'),
"Slow Query ({$query->time}ms): {$query->sql} | ".json_encode($query->bindings)."\n",
FILE_APPEND);
}
});
3、根据实际性能需求调整时间阈值，如 50ms 或 200ms。
四、结合 Laravel Telescope 进行可视化监控
Laravel Telescope 是官方提供的调试工具，能自动收集数据库查询信息，并提供 Web 界面查看，适合开发阶段使用。
1、通过 Composer 安装 Telescope：composer require laravel/telescope。
2、发布资源文件并执行迁移：php artisan telescope:install && php artisan migrate。
3、访问 /telescope 路径即可查看实时数据库查询列表，包括 SQL、执行时间、调用堆栈等详细信息。
4、可在 config/telescope.php 中配置数据保留策略和过滤规则。
