在 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 Illuminate\Support\Facades\DB;
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属性 - 在测试中使用
RefreshDatabasetrait 时，每次测试会重建连接，旧的 query log 会被清空
最稳妥的方式始终是：在入口（如控制器方法开头、命令 handle 方法第一行）调用 DB::enableQueryLog()，并在你想看结果的地方立刻调用 DB::getQueryLog() —— 中间不能有异步、协程或连接切换干扰。
