Laravel中如何查看SQL执行日志_Laravel开启打印SQL语句方法【技巧】

在 laravel 中需调用 DB::enableQueryLog() 启用日志，再用 DB::getQueryLog() 获取含 query、bindings、time 的数组；或用 DB::listen() 事件监听实时输出 sql，注意手动格式化 bindings。

如何在 Laravel 中实时查看 SQL 执行日志

默认情况下，Laravel 不会输出 SQL 语句到控制台或日志文件。要看到每条查询的完整 SQL（含绑定参数），必须主动启用查询日志并配合合适的位置触发输出。

DB::enableQueryLog() 和 DB::getQueryLog() 的正确用法

这对方法只对当前请求生命周期内执行的查询有效，且仅在调试环境安全使用；生产环境务必禁用。

• DB::enableQueryLog() 必须在查询执行前调用，否则之前已执行的 SQL 不会被记录
• DB::getQueryLog() 返回的是数组，每项是包含 query、bindings、time 的关联数组，不是字符串
• 如果用了 DB::table(...)->toSql() 或 ->explain() 这类不真正执行的构建器方法，它们不会出现在 query log 中

use IlluminateSupportFacadesDB;  DB::enableQueryLog();  User::where('active', 1)->get(); // 这条会被记录 $queries = DB::getQueryLog(); // 获取全部日志  foreach ($queries as $q) {     echo $q['query'] . ' | ' . json_encode($q['bindings']) . "n"; }

在 Artisan 命令或 Tinker 中打印 SQL 的快捷方式

命令行环境下更适合用事件监听方式，避免手动插桩。Laravel 的 DB::listen() 是更稳定的选择。

• 它会在每次查询执行后立即触发回调，无需提前开启/手动取值
• 回调参数中 $query 是带问号占位符的原始 SQL，$bindings 是实际传入的值，需手动替换才能看到“真实 SQL”
• 注意：$bindings 中的 NULL 值会被转成 NULL 字符串，字符串值默认不加引号，需自行格式化

DB::listen(function ($query) {     $sql = str_replace(['?', '%'], ['%s', '%%'], $query->sql);     $sql = vsprintf($sql, $query->bindings);     error_log('[SQL] ' . $sql); });

为什么 DB::connection()->enableQueryLog() 有时不生效

常见原因是连接复用或连接未被显式获取。Laravel 的 Eloquent 默认使用 default 连接，但某些场景（如队列、多数据库配置）可能走的是其他连接实例。

• 确保你操作的是同一个连接对象：直接用 DB::enableQueryLog()，不要写成 DB::connection('mysql')->enableQueryLog() 除非你明确切换了连接名
• 如果你在模型作用域（scope）或全局作用域中调试，记得检查该模型是否指定了 $connection 属性
• 在测试中使用 RefreshDatabase trait 时，每次测试会重建连接，旧的 query log 会被清空

最稳妥的方式始终是：在入口（如控制器方法开头、命令 handle 方法第一行）调用 DB::enableQueryLog()，并在你想看结果的地方立刻调用 DB::getQueryLog() —— 中间不能有异步、协程或连接切换干扰。