ThinkPHP如何开启调试模式_debug模式报错信息显示【技巧】

为什么开了 APP_DEBUG 还是白屏或 500？

ThinkPHP 的调试页面依赖 PHP 底层的错误输出能力。即使 APP_DEBUG = true，如果 PHP 自身屏蔽了错误，你照样看不到堆栈信息。

• 在入口文件中 define('APP_DEBUG', true) 后立即加：ini_set('display_errors', '1'); 和 error_reporting(E_ALL);
• Nginx + PHP-FPM 环境下，检查 fastcgi_params 是否包含 fastcgi_intercept_errors on; —— 必须设为 off，否则 Nginx 会吞掉 PHP 错误页
• Docker 或共享主机常见问题：镜像默认关了 display_errors，光改代码没用，得进容器改 php.ini 或启动时注入
• CLI 场景（比如 php think route:list）需额外加 -v 参数才能显示完整异常，不加则静默失败

.env 文件里的 APP_DEBUG=true 为什么有时不生效？

.env 是后备方案，优先级低于代码中的 define()。一旦你在入口文件写了 define('APP_DEBUG', ...)，.env 里无论写什么都无效。

• 常见陷阱：开发时在 .env 设了 APP_DEBUG=true，上线又加了 define('APP_DEBUG', false)，结果测试环境还显示调试面板——大概率是 runtime 缓存没清干净
• 确认 .env 文件编码为 UTF-8 无 BOM，等号两侧不能有空格，否则框架读不到
• TP6+ 中，APP_TRACE=true 才能启用右下角 Trace 面板，仅 APP_DEBUG=true 不够
• 清缓存不是可选项：删掉整个 runtime/ 目录（包括子目录和 ~runtime.php），否则旧配置可能被缓存沿用

调试模式开启后仍看不到 SQL 或变量信息？

TP6/8 把调试功能拆得更细，APP_DEBUG=true 只是总开关，具体能力需要单独开启。

• SQL 日志需确保 config/database.php 中 'debug' => true，且日志驱动未被覆盖
• 页面底部 Trace 面板需要 APP_TRACE=true（.env）或 'show_debug' => true（config/app.php，仅当 APP_DEBUG 为 true 时才读取）
• TP6 默认关闭 debug_show_exception，必须在 config/app.php 显式设为 true 才显示详细异常页
• 模板编译错误、路由未定义等底层问题，可能绕过 ThinkPHP 异常处理器，此时要查 PHP 错误日志（路径见 phpinfo() 的 error_log 行）

真正卡住人的地方，从来不是“怎么写那行 define”，而是“谁在哪儿悄悄把它覆盖了”——入口文件、.env、Dockerfile、Nginx 配置、甚至 CI 流水线脚本里都可能藏着 APP_DEBUG=false。验证时别只看 config/app.php，直接在控制器里 var_dump(defined('APP_DEBUG') && APP_DEBUG);，结果必须是 bool(true) 才算真正落地。