Class 'think\App' not found 表明 vendor/autoload.php 未成功加载，需检查 public/index.php 首行路径、Web 根目录是否为 public/、CLI 下 php think 是否正常，并用 die(class_exists('think\App') ? 'OK' : 'FAIL') 验证自动加载。
报错信息不是天书，ThinkPHP 的错误堆栈里藏着明确的定位线索——关键在于别跳过「文件路径+行号」，也别被“Class not found”这种表层提示带偏，真正的问题往往藏在自动加载、命名空间或环境配置里。
Class 'think\App' not found 是什么信号
这不是类文件丢了，是 vendor/autoload.php 根本没加载成功。框架启动链在第一行就断了，后续所有逻辑都不执行。
- 检查
public/index.php第一行是否为require __DIR__ . '/../vendor/autoload.php';—— 多一个点、少一个斜杠、写成./../vendor都会失败 - 确认 Web 服务器根目录指向的是
your-project/public/，不是项目根目录；否则相对路径解析全错 - 终端进项目根目录执行
php think，能输出命令列表才说明 CLI 环境下 autoload 正常；若报错，运行php --ini查 CLI 加载的php.ini是否启用了json、mbstring等必需扩展 - 加一行
die(class_exists('think\App') ? 'OK' : 'FAIL');在public/index.php最开头，直接验证自动加载通路
页面空白或只返回 500，但没报错内容
ThinkPHP 在非调试模式下默认屏蔽所有 PHP 错误，只扔一个 HTTP 500。你看到的“空白”，其实是错误被静默吞掉了。
- 在
public/index.php的<?php后立即加两行：ini_set('display_errors','1'); error_reporting(E_ALL); - 确保
.env中有APP_DEBUG=true，且未被config/app.php里的硬编码覆盖（框架以 config 文件为准） - 别只盯
runtime/log/，还要查：
– PHP 错误日志（php -i | grep error_log）
– Nginx 的/var/log/nginx/error.log或 Apache 的/var/log/apache2/error.log
–runtime/目录是否可写（属主需匹配 Web 进程用户，如www-data）
throw new Exception() 为什么没进自定义异常处理
ThinkPHP 8.0+ 只接管继承自 think\Exception 或其子类的异常，原生 Exception 被完全绕过——你写的 throw new \Exception() 等于主动放弃框架保护。
立即学习“PHP免费学习笔记（深入）”；
- 立刻替换所有
new \Exception()，改用new \think\exception\HttpException(500, '服务异常')或new \think\exception\ValidateException('验证失败') - 在控制器中写测试代码：
throw new \Exception('手动抛出');→ 若看到白屏或原始堆栈，说明框架未接管；若显示think_exception.tpl，才表示已生效 - 自定义异常处理器（如
app/exception/Handle.php）的render()方法里，必须调用parent::render($e)，否则 Trace 面板等调试功能不会注入响应
模板 fetch() 返回 false 或路由 404 却能通 /index.php/index
这不是控制器或方法不存在，是 URL 重写没生效，或服务器没把 PATH_INFO 传给 PHP。
- Apache 用户：确认项目根目录有正确
.htaccess，或宝塔后台选“ThinkPHP”伪静态规则 - Nginx 用户：server 块中必须含
try_files $uri $uri/ /index.php?$query_string;—— 少了$uri/会导致/admin/这类带斜杠路径直接 404 - 验证方法：访问
http://yourdomain.com/index.php/index能通，说明路由本身注册成功；不通则运行php think route:list看目标路由是否存在、HTTP 方法是否匹配 - 模板找不到？别急着放文件，先确认命名空间和路径是否严格匹配 PSR-4：比如
app\view\index\index.html对应控制器app\controller\Index.php中的namespace app\controller;
最易被忽略的一点：TP8+ 对反斜杠（\）极其敏感——new thinkApp() 和 new \think\App() 是两个世界；大小写、路径分隔符、PHP 版本与扩展启用状态，差一点，整个加载链就断在看不见的地方。
