TP8报错“Class not found”主因是命名空间错误或大小写不一致，需确保控制器以namespace app\controller;开头、类名严格匹配文件名；多应用须配置app_multi=true并规范目录结构；where条件二维数组成标准；框架类全由Composer加载；PHP版本必须≥8.0。
Class not found 错误不是路径问题，是命名空间没写对
TP8 下 ReflectionException: Class app\controller\IndexController does not exist 这类报错，90% 不是文件放错了位置，而是控制器类缺命名空间或大小写不一致。TP6 对命名空间容忍度高，TP8 依赖 PSR-4 自动加载，app/controller/IndexController.php 必须以 namespace app\controller; 开头，且类名必须严格匹配文件名（Linux 下 indexcontroller.php ≠ IndexController.php）。
- 检查每个控制器文件第一行是否含
namespace app\controller;（多应用下对应子应用命名空间，如app\admin\controller） - 确认类定义为
class IndexController extends BaseController，不能是class indexcontroller或class Indexcontroller - Windows 开发完务必在 Linux 环境测试一次，大小写敏感问题上线才暴露就晚了
多应用不能再靠 multi.php，得靠配置+目录结构双验证
TP6 的 app/multi.php 在 TP8 中完全失效，删掉它；否则你改了路由、加了子应用目录，TP8 仍当单应用跑。
- 全局启用多应用：在
config/app.php中显式设置'app_multi' => true - 每个子应用（如
app/admin）必须包含独立的config/和route/目录，哪怕只放一个空的config/app.php - 子应用路由不再自动合并到主路由，必须通过中间件或分组显式加载，例如在
app/middleware.php中注册应用级中间件来切换配置上下文
where 条件写法变了，二维数组成标准，索引数组语义已不同
TP8 中 where() 接收索引数组时行为改变：以前 ['id' => ['gt', 2]] 是“大于”，现在会当成 IN 查询处理，直接出错或查不到数据。
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
- 复合条件（含 >、where([['id', '>', 2], ['name', 'like', '%张']])
- 等值查询单条件仍可用索引数组：
where(['id' => 2, 'status' => 1]) - 等值查询多字段也支持索引数组，但一旦混入非等值条件，就必须切回二维格式，不能混用
- TP6 项目升级后务必全局 grep
where\[(\[.*?|'.*?')\]，批量替换老写法
thinkphp/ 目录没了，所有框架类都走 Composer 加载
TP8 不再有 thinkphp/ 目录，think\App、think\Db 等核心类全由 vendor/topthink/framework 提供，手动 require 或硬编码路径引用全部失效。
- 删掉所有类似
require_once 'thinkphp/library/think/Route.php'的代码 - 不要修改
vendor/下任何文件——打补丁必须通过服务提供者或事件监听器方式注入 - 若用了第三方扩展依赖旧版
thinkphp/路径（比如某些老版验证码包），要么找新版替代，要么 fork 后重写加载逻辑
最常被忽略的是 PHP 版本和容器反射的隐性耦合：TP8 强制要求 PHP ≥8.0，不是“能跑就行”，而是 Container 类底层彻底重构了反射调用方式；TP6 在 PHP 8 下即使没报错，依赖注入也可能漏掉参数，导致运行时行为异常——这种问题不会报错，只会“结果不对”。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
