ThinkPHP 8.0升级需严格遵循PHP 8.0+语义与PSR-4规范：类名文件名必须完全一致；中间件需实现MiddlewareInterface并声明handle()返回类型为\think\Response；助手函数需在composer.json中配置autoload.files并执行dump-autoload；Db/模型查询结果须调用toArray()；路由where条件混用操作符时必须使用二维数组格式。
刚把ThinkPHP 6.0项目拉起来准备升级到8.0，运行就报Class not found、handle()返回值类型错误、dump()函数找不到——这不是代码写错了，是TP8强制执行PHP 8.0+语义和PSR-4加载规则后，老写法直接被拦截在解析阶段。
命名空间与类引用必须严格匹配文件名
打开app/controller/Index.php，确认第一行是namespace app\controller;，且类定义为class Index extends BaseController。
Linux服务器上，【文件名必须与类名完全一致，Index.php不能写成index.php或IndexController.php】，否则TP8的PSR-4自动加载器直接跳过，不报错也不提示，只返回ClassNotFoundException。
检查所有模型文件：app/model/User.php → class User；若写成class UserModel，就必须改文件名为UserModel.php。
立即学习“PHP免费学习笔记（深入）”；
中间件handle()方法必须声明返回类型
TP8强制要求中间件实现think\contract\MiddlewareInterface接口，并标注handle()返回值为\think\Response。
方法一：补全接口与类型声明
在app/middleware/Auth.php中，将原TP6写法：
public function handle($request, \Closure $next) { return $next($request); }
改为：
use think\contract\MiddlewareInterface;<br>class Auth implements MiddlewareInterface {<br> public function handle($request, \Closure $next): \think\Response {<br> return $next($request);<br> }<br>}
方法二：不改类定义，但全局注册时用::class常量
在app/middleware.php中，必须写app\middleware\Auth::class，不能写字符串'app\middleware\Auth'——TP8会因反射失败静默跳过该中间件。
助手函数在CLI下默认不加载
第一步：确认composer.json已声明autoload.files
检查根目录composer.json，确保"autoload"区块包含：
"files": ["app/helper.php"]
第二步：执行重载命令
运行composer dump-autoload，否则新增的files配置不会生效。
第三步：清空runtime缓存
删除runtime/目录下所有内容，再执行php think clear——旧缓存里可能残留TP6的helper加载逻辑，导致CLI下dump()仍报错。
数据库查询返回值类型变了
1. 所有Db::table()->where()->find()调用后，不能再直接用isset($data['id'])判断——TP8返回的是think\model\Pivot实例，不是数组。
2. 必须显式调用toArray()才能转为数组：$data = Db::table('user')->where('id', 1)->find()->toArray();
3. 模型查询同理：UserModel::find(1)->toArray()，漏掉toArray()会导致foreach遍历时触发BadMethodCallException。
注意：TP8中toarray()（小写a）是无效方法名，必须是toArray()（驼峰），拼错就报Fatal error。
路由where条件必须用二维数组格式
TP6允许写where(['id' => ['gt', 5]])，TP8会将其误判为IN查询，查不到数据也不报错。
必须统一改为二维数组格式：
where([['id', '>', 5]])where([['status', '=', 1], ['name', 'like', '%admin%']])
等值查询单条件可保留索引数组：where(['id' => 1, 'status' => 1])，但一旦混入>、like等操作符，就必须切回二维格式，【索引与二维数组不可混用】。
