ThinkPHP8数据库连接如何开启Debug？_ThinkPHP8开启连接调试日志【开发】
PhpStorm 是 JetBrains 推出的专业 PHP 集成开发环境，可在 Mac 上完成代码编写、智能检查、重构、调试、测试和数据库管理。它支持主流 PHP 框架、Composer、Git、Docker 与远程解释器。
在ThinkPHP8中，开启数据库SQL日志必须同时满足三个条件：第一，调试模式（APP_DEBUG）必须设置为true；第二，日志记录级别必须包含'sql'；第三，数据库配置文件中启用日志选项。需要注意的是，APP_DEBUG必须在入口文件public/index.php中手动定义，.env文件无法覆盖此设置，否则日志不会显示。
在ThinkPHP8中，想要看到数据库的SQL日志，并不是打开一个开关那么简单。它需要同时满足三个条件——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，确认在之后的第一行就是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/ 对应日期的文件里。你也可以通过一个返回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/ 目录都不会生成对应的日志文件。
火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力，依托字节自研豆包多模态大模型，凭借火山方舟一站式平台，提供模型精调、推理部署、智能应用搭建等全链路服务，结合高性能AI算力，助力各行业快速落地大模型数字化与智能化应用。
AirBuddy 3 是面向 macOS 的蓝牙外设增强工具，可集中查看 AirPods、Beats 与苹果设备电量，提供快速连接、播放控制、电量提醒、桌面小组件和多台 Mac 外设接力等功能。
AirServer macOS版可把 Mac 转换为无线投屏接收端，通过 AirPlay 或 Google Cast 接收手机、平板和电脑画面，并支持多设备同时连接、高清镜像及会话录制，适合家庭娱乐、课堂教学、会议演示和应用展示。
Autodesk Maya 是面向影视、电视、动画和游戏行业的专业三维制作软件，集多边形与 NURBS 建模、角色绑定、关键帧和动作捕捉动画、Bifrost 特效模拟、材质开发及 Arnold 渲染于一体，
AirServer Windows版可把电脑变成AirPlay、Google Cast和Miracast无线投屏接收端，适合会议演示、课堂教学及家庭大屏分享。发送设备通常无需另装客户端，并可同时接收和智能排列多个镜像会话。