调试模式未生效，因tp5.1仅认入口文件顶部define('app_debug', true)，必须置于第一行，其他位置设置无效。
您正在开发ThinkPHP5.1项目，但页面空白、SQL不显示、右下角没有Trace图标——这说明调试模式未真正生效。TP5.1的调试开关不是改个配置就能用，它必须在框架加载前就“钉死”在入口文件顶部，否则后续所有设置都无效。
入口文件第一行定义APP_DEBUG（唯一权威方式）
ThinkPHP5.1只认入口文件最顶部的define('APP_DEBUG', true)，其他任何地方写都晚了。这个常量必须在php之后、任何require之前，且不能有任何空行或BOM。
打开项目根目录下的index.php（注意：不是public/index.php），找到开头：
✅ 正确写法（立刻执行，无空行）：
```php
define('APP_DEBUG', true);
require __DIR__ . '/thinkphp/start.php';
```
❌ 错误写法举例：
— 写在require之后
— 写成define('APP_DEBUG', 'true')或define('APP_DEBUG', 1)
— 前面有空行、注释、echo或BOM字符
— 放在config/app.php里改'app_debug' => true
【必须删除整个runtime/目录】，包括子目录cache/、log/、template/和隐藏文件~runtime.php。缓存不清理，旧配置会继续运行，改了等于没改。
让错误堆栈真正显示出来
开了APP_DEBUG却还是白屏？因为PHP底层错误输出被关了。TP5.1不会自动帮你开display_errors。
在index.php中define('APP_DEBUG', true)后面紧接两行：
```php
ini_set('display_errors', '1');
error_reporting(E_ALL);
```
如果用Nginx + PHP-FPM，还要检查fastcgi_params配置里是否有fastcgi_intercept_errors on;——有就得改成off，否则Nginx会吞掉ThinkPHP渲染的错误页，只返回空白或500。
启用Trace面板（右下角小图标）
Trace不是调试模式的附属品，它是独立开关。即使APP_DEBUG=true，没有开启Trace，右下角也不会出现图标。
方法一：在.env文件中添加（推荐，多环境统一管理）
确保项目根目录有UTF-8无BOM编码的.env文件，内容为：
APP_DEBUG=true
APP_TRACE=true
等号两侧绝对不能有空格
方法二：在index.php中直接定义
在define('APP_DEBUG', true)之后加：
define('APP_TRACE', true);
改完同样要清空runtime/目录，否则Trace配置不加载。
验证是否生效（四步现场检测）
第一步：访问一个不存在的控制器，比如http://yourdomain.com/index.php/abc
第二步：观察是否出现完整的ClassNotFoundException堆栈，而不是“系统繁忙”或空白页
第三步：打开任意正常页面，看右下角是否出现ThinkPHP LOGO图标
第四步：点击图标，确认能展开“基本、SQL、错误、调试”等选项卡
如果前三步任一失败，立即回到入口文件检查define位置和runtime清理；如果第四步缺SQL或调试选项卡，检查数据库配置中'log' => ['enable' => true]是否开启。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
