必须开启SQL日志以追踪数据库操作，方法包括：一、启用全局调试并配置log.level为['sql']；二、入口文件动态初始化Log；三、用Db::listen()监听原始SQL；四、开启sql_explain分析执行计划；五、通过Trace面板可视化查看。
如果您在ThinkPHP项目中需要追踪数据库操作、排查SQL错误或分析性能瓶颈，则必须确保SQL执行日志被正确开启与落盘。以下是实现该目标的多种配置方式：
一、启用全局数据库调试并配置SQL日志级别
此方法通过框架核心配置激活SQL日志记录能力，适用于大多数标准部署场景，依赖app_debug开启及log.level显式声明sql级别。
1、确认APP_DEBUG环境变量为true，可在.env文件中设置：APP_DEBUG=true。
2、在config/log.php中配置日志驱动与级别：'type' => 'File', 'level' => ['sql']。
立即学习“PHP免费学习笔记（深入）”；
3、在config/database.php中确保数据库调试开关打开：'debug' => true。
4、访问任意触发数据库操作的接口后，检查runtime/log/目录下按日期生成的日志文件，其中包含形如[SQL ]SELECT * FROM `think_user` [RunTime:0.000539s]的记录。
二、在入口文件中动态初始化SQL日志
当项目已关闭默认日志（如log.type=test）但又需临时启用SQL日志时，可在公共入口处绕过配置文件限制，强制初始化日志驱动。
1、打开public/index.php文件，在require __DIR__.'/../thinkphp/start.php';之前插入初始化代码。
2、调用\think\Log::init()方法并传入完整配置：\think\Log::init(['type' => 'File', 'path' => RUNTIME_PATH.'log/', 'level' => ['sql']])。
3、确保RUNTIME_PATH.'log/'目录存在且Web服务器进程具有写入权限。
4、再次请求接口，观察runtime/log/目录是否生成含SQL语句的新日志文件。
三、使用Db::listen()监听器捕获原始SQL与绑定参数
该方式不依赖日志系统自动记录，而是通过回调函数实时获取带占位符的SQL语句和真实绑定值，适合深度调试、审计或对接外部监控系统。
1、在控制器方法开头或全局中间件中添加监听逻辑：Db::listen(function ($sql, $time, $explain) { dump($sql); });。
2、若需记录完整上下文，改用Log::info()分离存储：Log::info('SQL executed', ['sql' => $sql, 'bind' => var_export($params['bind'], true), 'duration' => $time]);。
3、注意监听器启用后，默认SQL日志将被禁用，需自行接管全部记录逻辑。
4、在异常捕获块中配合Db::getLastSql()可补全失败语句：echo Db::getLastSql();。
四、开启SQL性能分析并记录EXPLAIN结果
当需要定位慢查询或索引缺失问题时，启用SQL执行计划分析功能可在日志中附加MySQL原生EXPLAIN输出，辅助判断查询效率。
1、在config/database.php中设置：'sql_explain' => true。
2、确保'debug' => true已启用，否则sql_explain无效。
3、触发SQL执行后，查看日志中是否出现类似[EXPLAIN :array ('id'=>'1','select_type'=>'SIMPLE','type'=>'ALL',...)]的结构化分析数据。
4、重点关注type字段（如ALL表示全表扫描）、key（是否命中索引）、rows（扫描行数）等关键指标。
五、通过Trace面板在页面底部直接查看SQL
此方式无需读取日志文件，适用于开发环境快速验证SQL生成是否符合预期，所有SQL语句及执行耗时会以可视化形式聚合展示在HTTP响应末尾。
1、确认APP_DEBUG=true且log.level包含sql，同时database.debug=true已启用。
2、访问任意含数据库操作的页面，滚动至浏览器页面最底部。
3、点击展开SQL标签页，查看当前请求生命周期内所有执行过的SQL语句及其RunTime耗时。
4、若未显示，请检查浏览器开发者工具Console是否存在JavaScript错误，或确认think\facade\Debug未被禁用。
