升级ThinkPHP 6.0至8.0需先确认ORM为2.x及PHP≥8.1，再更新composer.json中framework、think-orm等依赖至对应8.x/3.x版本并删除composer.lock；随后适配ORM 3.0的find/select返回类型、关联预载入改用load()、验证器规则语法及临时启用数据库strict模式排查问题。
将运行在ThinkPHP 6.0上的老项目升级到8.0，需重点解决think-orm从2.x升至3.0带来的查询语法、返回类型和事件机制变化，否则模型调用会静默失败或返回null而无报错提示，业务逻辑可能在用户无感知时中断。
确认当前ORM版本与PHP环境
进入项目根目录，执行php think version确认框架为6.x；再运行composer show topthink/think-orm查看当前ORM版本。若显示v2.0.x或v2.1.x，说明尚未升级——这正是后续所有兼容性问题的起点。
同时检查PHP版本：php -v必须输出8.0.0或更高版本。ThinkPHP 8.0【强制要求PHP 8.1+】，低于此版本会导致构造函数属性提升、联合类型等核心语法直接报错，连autoload都可能失败。
替换核心依赖并清理锁文件
方法一：手动编辑composer.json
将原文件中"topthink/framework": "^6.0"改为"^8.0"；"topthink/think-orm": "^2.0"改为"^3.0"；"topthink/think-filesystem": "^1.0"改为"^2.0"。其他如think-validate、think-cache等官方包也需同步查文档确认是否需升级主版本。
立即学习“PHP免费学习笔记（深入）”；
方法二：使用参考项目比对
新建临时目录，执行composer create-project topthink/think tp8-ref，打开tp8-ref/composer.json复制require区块完整覆盖原项目对应部分。这能避免漏掉psr/log、psr/container等底层依赖的隐式升级要求。
完成修改后，【务必删除当前项目的composer.lock文件】。不删锁文件会导致Composer复用旧依赖图，即使改了json，install/update仍可能拉取v2.0的ORM，升级形同虚设。
适配ThinkORM 3.0关键变更
第一步：检查所有模型类的find()、select()调用位置
ThinkORM 3.0默认返回?Model或Collection，不再自动抛出异常。若代码中存在if ($user->name) { ... }这类判空逻辑，而未先判断$user !== null，则PHP 8.1严格类型下会触发TypeError。
第二步：重写带条件的关联预载入
TP6写法$user->with('posts.status')->find(1)在TP8中失效。新写法必须显式调用load()：$user = User::find(1); $user->load('posts.status');。漏掉这一步，关联数据永远为空，且无任何警告。
第三步：验证器规则迁移
原['require', 'email']需改为['required', 'email']；in规则参数从字符串'1,2,3'变为数组[1,2,3]。ThinkORM 3.0的验证器已完全解耦，沿用TP6风格会导致规则被跳过。
第四步：关闭严格模式（仅调试期）
在config/database.php中添加'strict' => false。此举可让SQL错误以异常形式抛出，而非静默返回false——这是定位ORM层查询失败最直接的手段。上线前必须移除。
