调试模式不开启主因是APP_DEBUG常量被覆盖或未在入口文件顶部正确定义；需在public/index.php最顶部立即定义，且配合display_errors开启、清空runtime缓存并验证实际值。
调试模式不开启，90% 的情况不是没写 APP_DEBUG，而是它被覆盖、被忽略、或者根本没生效。
入口文件 define('APP_DEBUG', true) 写错位置
ThinkPHP 在 require 框架启动文件（如 thinkphp/base.php）前就检查 APP_DEBUG 常量。一旦错过这个时机，后面怎么改都无效。
- ✅ 正确：在
public/index.php最顶部、<?php后立即写define('APP_DEBUG', true); - ❌ 错误：写在
require __DIR__ . '/../vendor/autoload.php';之后，或写在控制器、中间件里 - ❌ 错误：在
config/app.php里设'app_debug' => true—— 这个配置只在APP_DEBUG === true时才被读取，单独设它等于没设
.env 文件的 APP_DEBUG 被代码硬编码覆盖
.env 中的 APP_DEBUG=true 只是 fallback 方案：只有当 PHP 代码中完全没定义 APP_DEBUG 常量时，框架才会去读它。只要入口文件写了 define('APP_DEBUG', false)，.env 就彻底失效。
- 检查
public/index.php是否存在define('APP_DEBUG', ...)—— 如果有，删掉或改成true - 运行
php think run时，CLI 入口（如think文件）也得单独处理，不能只改 Web 入口 - 验证是否生效：在任意控制器里加
var_dump(defined('APP_DEBUG') && APP_DEBUG);，必须输出bool(true)
开了 APP_DEBUG 却看不到错误页面
ThinkPHP 调试模式依赖 PHP 底层错误机制才能渲染堆栈。如果 display_errors 被关了，或被 Nginx/PHP-FPM 拦截，你只会看到白屏或 500。
立即学习“PHP免费学习笔记（深入）”；
- 在
public/index.php顶部、define之后立刻加：ini_set('display_errors', '1'); - Nginx + PHP-FPM 环境下，确认
fastcgi_intercept_errors off;，否则错误页会被 Nginx 拦截成 50x 页面 - 检查
php.ini或 Docker 容器启动参数里是否设置了display_errors = Off，这个优先级高于ini_set - TP6+ 还需确认
config/app.php中'debug_show_exception' => true，否则即使APP_DEBUG为 true，也不显示异常页面
多环境混合部署时实际值和预期不一致
最麻烦的是“你以为开了，其实没开”——比如测试服务器用了旧版入口文件，而开发机用的是 .env；又或者 CI/CD 流程里自动注入了 APP_DEBUG=false 环境变量。
- 不要信任任何单一配置源，每次怀疑时都直接在控制器里
var_dump(get_defined_constants()['APP_DEBUG'] ?? null); - 清空
runtime/目录（尤其是~runtime.php），缓存会固化上一次的调试状态 - TP6+ 中，
env('APP_DEBUG')返回的只是环境变量值，不等于框架实际使用的APP_DEBUG常量值 —— 二者可能完全不同
真正卡住人的地方，从来不是“怎么写”，而是“谁先加载、谁后覆盖、谁悄悄把它关掉了”。尤其在团队协作或容器化部署中，APP_DEBUG 的实际值往往藏在某次忘记清理的缓存、某个被忽略的 CLI 入口、或某条没注释掉的 define 里。
