thinkphp8数据库sql日志需同时满足三个条件：app_debug=true（必须在入口文件顶部定义，.env无效）、log.level包含'sql'、数据库配置中'log'=>['enable'=>true]（默认开启），缺一不可。
ThinkPHP8 的数据库连接调试日志，不是靠“开个开关”就自动出来，而是必须同时满足三个条件：APP_DEBUG=true、log.level 包含 'sql'、且数据库配置中 'log' => ['enable' => true]（默认已开）。缺一不可。
APP_DEBUG 必须在入口文件顶部定义，.env 不能替代它
很多人改了 .env 里的 APP_DEBUG=true 却看不到 SQL 日志，是因为入口文件 public/index.php 里已经写了 define('APP_DEBUG', false) 或类似语句——它会直接覆盖 .env。TP8 官方明确不鼓励用 .env 控制调试开关，因为这会让 App::isDebug() 判断失准，进而影响日志通道是否启用。
实操建议：
- 打开
public/index.php，确认第一行 PHP 代码（<?php后）就是define('APP_DEBUG', true);，前面不能有任何空行、BOM、注释或输出 - 删掉所有其他位置的
define('APP_DEBUG', ...)，包括控制器、中间件、命令行入口 - 如果用了多入口（如
admin/index.php），每个都要单独加 - 改完后清空
runtime/目录，否则旧缓存可能让日志不刷新
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/ 对应日期的文件里，也能在 Trace 面板的 “SQL” 标签页里通过 HTML 页面间接查看。
实操建议：
- 调试接口时，临时加个 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/ 目录都不会生成对应文件。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
