ThinkPHP 8 的 Trace 调试面板需同时满足 APP_DEBUG=true 和 APP_TRACE=true（均在 .env 中严格配置），并清空 runtime 缓存、确保 UTF-8 无 BOM 编码及运行时目录可写，且仅在 HTML 响应中显示；SQL 标签页内容依赖 log.php 中 level 包含 'sql'。
ThinkPHP 8 的 Trace 调试面板不是“开了就能看见”的功能，它依赖 APP_DEBUG 和 APP_TRACE 同时为 true，且必须清空 runtime 缓存；否则右下角图标不出现、SQL 标签页为空、甚至整个面板完全不渲染。
APP_DEBUG 和 APP_TRACE 必须同时启用
Trace 面板是调试模式的子功能，不是独立开关。只设 APP_TRACE=true 而 APP_DEBUG=false，面板不会加载；反过来，APP_DEBUG=true 但 APP_TRACE=false，则只有错误堆栈和日志，没有 Trace 图标。
-
APP_DEBUG=true是前提：决定是否进入调试上下文，影响异常页面、SQL 日志、模板编译等底层行为 -
APP_TRACE=true是显式开关：告诉框架在响应 HTML 时注入 Trace 渲染逻辑 - 两者都必须通过
.env文件设置（TP8 官方推荐），且格式严格：APP_DEBUG=true（等号两侧**不能有空格**） - 若入口文件
public/index.php中还残留define('APP_DEBUG', true)，会干扰环境变量加载，导致APP_TRACE失效
Trace 面板不显示？先清空 runtime 并检查编码
TP8 的配置缓存固化在 runtime/ 目录下，尤其是 runtime/container/ 和 runtime/cache/。改了 .env 但没清缓存，等于没改。
- 手动删除整个
runtime/目录（不要只删部分子目录） - 确保
.env文件是 UTF-8 **无 BOM** 编码——用 VS Code、Notepad++ 等编辑器另存时勾选“UTF-8 无 BOM”，BOM 会导致框架静默跳过该文件 - 确认 Web 服务器用户对
runtime/有写权限（常见于 Docker 或 Nginx 部署时权限不足） - 访问一个返回 HTML 的路由（如
/index），Trace 面板**不会出现在 JSON 接口响应中**，这是设计行为，不是 bug
SQL 语句点不开？检查 log.php 的 level 配置
Trace 面板里的 “SQL” 标签页内容来自日志系统，不是实时抓取。即使 APP_TRACE=true，如果日志级别没包含 sql，面板就只显示数量，不展示具体语句。
立即学习“PHP免费学习笔记（深入）”；
- 打开
config/log.php，确认'level'数组中包含'sql'：
return [
'level' => ['error', 'sql', 'notice'],
];runtime/log/ 下的详细日志上线前关掉 Trace 不只是改 .env
把 APP_DEBUG=false 写进 .env 是第一步，但生产环境常漏掉三处残留：
- Git 忽略了
.env，导致线上实际仍是APP_DEBUG=true -
runtime/log/中积累了大量含敏感信息的日志（如完整 SQL、POST 数据），需定期清理或禁用sql级别 - 某些中间件或自定义异常处理器里硬编码了
trace()调用，会在响应头或注释中意外输出调试信息
最稳妥的做法：上线部署脚本里加入 php think clear + 删除 runtime/ + 验证 var_dump(app()->isDebug()) 返回 false。
