thinkphp5.1调试模式未生效的主因是app_debug未在index.php首行严格定义，必须紧贴
ThinkPHP5.1项目在开发中无法显示错误堆栈、SQL日志或右下角Trace面板，说明调试模式未真正激活——这通常不是配置没写，而是写错位置、被缓存掩盖或底层PHP错误输出被关闭。
入口文件第一行定义APP_DEBUG
这是TP5.1唯一权威且必选的方式，其他任何地方修改都无效。
打开项目根目录下的 index.php（注意：不是public/index.php），找到文件最顶部的<?php 标签。
在<?php 后**立刻**插入一行代码，前面不能有任何空行、BOM、注释或空白字符：
define('APP_DEBUG', true);
【必须是布尔值true，写成'true'、1、TRUE或app_debug都会失效】
确认这行代码位于所有require、include及框架加载语句之前，例如必须出现在require __DIR__.'/thinkphp/start.php';之前。
若项目存在多个入口（如admin.php、api.php），每个都要单独添加这一行。
配套开启PHP底层错误显示
仅设APP_DEBUG = true，页面仍可能白屏或返回500——因为TP5.1不自动打开PHP错误输出。
方法一：在index.php中define('APP_DEBUG', true);后紧接添加两行：
ini_set('display_errors', '1');
error_reporting(E_ALL);
方法二：直接修改php.ini，确保以下两项生效：
display_errors = On
error_reporting = E_ALL
【Nginx + PHP-FPM用户务必检查fastcgi_intercept_errors off;，否则Nginx会吞掉ThinkPHP渲染的错误页】
清空runtime缓存目录
ThinkPHP5.1会将配置、模板、日志全部缓存到runtime/目录，改完配置不清理等于没改。
第一步：进入项目根目录，定位到runtime/文件夹。
第二步：彻底删除该目录下所有内容，包括子目录（cache/、log/、temp/、view/）和隐藏文件（如~runtime.php）。
第三步：确保runtime/目录权限可写，PHP进程能重新生成新缓存。
这一步不可跳过。哪怕只删了log/而留着cache/，旧的调试开关判断结果仍会被沿用。
验证是否生效
刷新任意HTTP页面，观察以下三项现象：
页面右下角出现灰色Trace小图标，点击可展开请求流程、SQL执行、变量列表；
访问一个不存在的控制器（如/index/missing），显示完整的ClassNotFoundException堆栈而非“系统繁忙”或白屏；
runtime/log/目录下生成带时间戳的.log文件，内容含SQL绑定参数与执行耗时。
若仍失败，请立即查看PHP错误日志路径（通过phpinfo()确认），而不是反复修改ThinkPHP配置。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
