ThinkPHP报错可5分钟内定位根因：错误级别决定严重性，错误描述指明问题类型（如Class not found是PSR-4加载失败），文件路径与行号指向位置但真因常在上一行；命名空间、路径、大小写、异常继承链三者必须严格对齐。
ThinkPHP报错不是“看不懂”，而是你没按它的结构去拆解——错误信息里藏着三个确定性线索：错误类型、出错位置、触发上下文。只要盯住这三点，90%的报错5分钟内就能定位到根因。
看懂报错三要素：错误级别 + 描述 + 行号
ThinkPHP的错误页面或日志里，每条报错都严格遵循「错误级别 + 错误描述 + 文件路径与行号」结构。别跳着读，从后往前看更高效：
- 先找
in /path/to/Controller.php on line 27—— 这是真实发生点，但问题往往在上一行（比如漏了分号、括号没闭合、use语句写错） - 再看错误描述，例如
Class 'app\controller\User' not found，说明是自动加载失败，不是语法错，不用查if逻辑 - 最后确认错误级别：
Fatal error必须立刻停；Notice可暂不处理；Parse error说明PHP根本没开始执行，只盯当前文件的语法
类找不到？优先检查命名空间和路径是否对齐
这是新手踩坑率最高的问题，尤其在TP6+版本。PSR-4规范下，“文件在哪”和“类叫什么”必须完全一致：
-
app\controller\User.php的命名空间必须是namespace app\controller;，不能写成App\Controller或app/controller（少反斜杠） - Linux服务器大小写敏感，
User.php和user.php是两个文件，但你在Windows上可能一直没发现 - 如果用了子命名空间，比如
app\api\v1\User，那文件路径必须是app/api/v1/User.php，中间不能缺v1目录
TP8报错白屏或没进自定义Handler？检查异常继承链
ThinkPHP 8.0彻底绕过了原生 Exception，只接管 \think\Exception 及其子类。如果你写了 throw new \Exception('xxx')，框架根本不会捕获，直接交给PHP底层，导致白屏或默认500页：
立即学习“PHP免费学习笔记（深入）”；
- 业务代码中所有
throw new Exception()必须改成throw new \think\exception\HttpException(500, 'xxx')或对应子类（如ValidateException） - 测试是否生效：在控制器里写一行
throw new \think\exception\HttpException(404);，访问后看到think_exception.tpl页面才算接管成功 - 配置了
exception_handle后，http_exception_template就失效了——因为渲染流程已由你写的render()方法全权控制
空白页没报错？打开错误显示并查 runtime/log
生产环境默认屏蔽错误，开发时却常因配置遗漏卡在“什么都看不到”的状态：
- 确保
APP_DEBUG = true（在.env或config/app.php中），否则连堆栈都不会输出 - 若仍空白，检查
php.ini中display_errors = On和error_reporting = E_ALL是否生效；临时可在入口文件加ini_set('display_errors', '1'); error_reporting(E_ALL); - 最终线索在
runtime/log/下的日期文件里，搜索关键词如SQLSTATE、Connection refused、Undefined index，比页面提示更原始也更准
真正卡住人的从来不是报错本身，而是把“类不存在”当成逻辑错去翻业务代码，或者在TP8里用原生Exception假装框架能兜底。盯住路径、命名空间、异常类继承这三处，比任何调试技巧都管用。
