ThinkPHP 8.0 的 Trace 调试面板需同时启用 APP_DEBUG=true 和 APP_TRACE=true（均写于 .env，无空格），并清空 runtime/、确保 UTF-8 无 BOM 编码及目录写权限；仅在 HTML 响应中显示，且 SQL 标签页依赖 log.php 中 'sql' 日志级别配置。

ThinkPHP 8.0 的性能追踪主要通过 **Trace 调试面板**实现，但它不是单纯的“开启开关”，而是一套需严格配置、协同生效的调试机制。核心目标是观察请求生命周期、SQL 执行、模板渲染、缓存读写等关键耗时环节——但前提是环境、配置、缓存、响应类型全部就位。

必须同时启用两个开关

Trace 面板依赖 APP_DEBUG 和 APP_TRACE 同时为 true，缺一不可：

• APP_DEBUG=true 是前提：决定是否进入调试上下文，影响异常页面、日志级别、模板编译行为
• APP_TRACE=true 是显式触发：告诉框架在 HTML 响应中注入 Trace 渲染逻辑
• 二者都必须写在 .env 文件中，且等号两侧不能有空格，例如：APP_DEBUG=true（✘APP_DEBUG = true）
• 如果 public/index.php 中还残留 define('APP_DEBUG', true)，会干扰环境变量加载，导致 APP_TRACE 失效

清空缓存并检查文件编码

TP8 将配置和容器信息固化在 runtime/ 目录下，改了 .env 不清缓存=白改：

• 手动删除整个 runtime/ 目录（不要只删子目录）
• 确保 .env 文件是 UTF-8 无 BOM 编码（VS Code 或 Notepad++ 另存时勾选“UTF-8 无 BOM”）
• 确认 Web 服务器用户（如 www-data、nginx）对 runtime/ 有写权限（Docker/Nginx 部署常见权限问题）

仅在 HTML 响应中显示

Trace 面板不会出现在 JSON、XML 或 API 接口响应中，这是设计行为：

PHP 8.5.12

修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。

下载

• 访问一个返回完整 HTML 页面的路由（如 /、/index），右下角才会出现 Trace 图标
• 若用 Postman 或 curl 请求接口，看不到面板属正常，不代表没开启成功

让 SQL 标签页真正可用

Trace 中的 SQL 标签页内容来自日志系统，不是实时抓取。即使 APP_TRACE=true，若日志未记录 SQL，面板只显示数量，不展示语句：

立即学习“PHP免费学习笔记（深入）”；

• 打开 config/log.php，确认 'level' 数组包含 'sql'，例如：
  'level' => ['error', 'sql', 'notice']
• 若使用自定义数据库连接（如读写分离），需确保所有连接都启用了 trace_sql（默认开启，但手动关闭过需复查）
• SQL 按执行时间倒序排列，适合快速定位慢查询；完整上下文（哪行代码触发）仍需查 runtime/log/ 下的日志文件

不复杂但容易忽略