ThinkPHP8数据库连接如何开启Debug？_ThinkPHP8开启连接调试日志【开发】

config/log.php 的 level 必须显式包含 'sql'

即使 APP_DEBUG 已经设为 true，在Trace面板中看到“SQL: 12 条”的提示，点开后却发现没有具体语句——这种情况多半是 config/log.php 的配置出了问题。TP8默认只记录 error 和 notice 级别的日志，而 sql 是一个可选通道，需要手动加入才能生效。

具体操作：

• 打开 config/log.php，找到 'level' => 数组
• 确认数组里包含 'sql'，例如这样写：return ['level' => ['error', 'sql', 'notice']];
• 注意：不要写成 'sql_log' 或 'database'，TP8只认 'sql' 这个关键字
• 如果使用了自定义日志驱动（比如 Monolog），要确认它支持 sql 级别并已经完成桥接

数据库配置里的 log.enable 默认为 true，但容易被覆盖

TP8的数据库连接日志开关实际上由两层控制：上层是全局的 log.level，下层是数据库配置中的 'log' => ['enable' => true]。后者的默认值是开启的，但如果你在 config/database.php 里手动设置了 'log' => false，或者通过环境变量覆盖了它（比如 DATABASE_LOG_ENABLE=false），SQL日志就不会被记录。

需要留意的几个点：

• 检查 config/database.php 中的 'log' 配置项，确认没有显式设为 false
• 如果使用 .env 配置数据库参数，搜索一下是否有 DATABASE_LOG_ENABLE 或类似的变量
• 若想查看更详细的连接过程（比如重连、断线检测），可以在数据库配置中临时添加 'verbose' => true，它会额外记录PDO构建和连接状态
• 需要提醒的是：开启 trace_sql 会把完整SQL语句及参数一起写入日志，敏感信息（如密码字段的值）可能会泄露。这个功能在开发环境使用没问题，上线前务必关闭

页面返回 JSON 时看不到 Trace 面板，但 SQL 日志仍在

这其实是设计行为，不是bug。TP8右下角的Trace面板只在响应的Content-Type为 text/html 时才会渲染。API接口返回的是JSON格式数据，面板自然就不会显示——但只要上面三个条件都满足，SQL依然会被记录到 runtime/log/ 对应日期的文件里。你也可以通过一个返回HTML的页面间接查看Trace面板里的“SQL”标签页。

实际调试建议：

• 调试接口时，可以临时增加一个返回HTML的路由（如 /debug/sql），在里面执行相同的查询，然后通过Trace面板查看SQL
• 直接查看日志文件：tail -f runtime/log/20260510.log，并过滤 SQL: 关键词
• 如果连日志文件都没有生成，优先检查 runtime/ 目录的写入权限，以及 log.file 配置的路径是否正确（默认路径是 runtime/log/）

最容易被忽略的一点是：APP_DEBUG 控制的不仅仅是“是否显示错误信息”，它直接决定了数据库连接是否启用日志通道。哪怕你把 log.level 和 database.log.enable 都设置正确了，只要 APP_DEBUG 没有在入口文件顶部生效，SQL就根本不会进入日志系统——连 runtime/log/ 目录都不会生成对应的日志文件。