必须先完成ThinkPHP 6.0迁移并确保PHP≥8.1.0、扩展齐全，再通过替换依赖、删除composer.lock、适配ORM 3.0的返回类型、关联加载、验证规则及字段限制等变更，最后清缓存并重跑优化。
将运行在ThinkPHP 6.0的老项目升级到8.0，必须处理think-orm从2.x升至3.0带来的查询返回类型变更、关联预载入语法失效、验证器规则语义迁移等关键问题，否则模型调用会静默返回null而无报错，业务逻辑可能在用户无感知时中断。
确认当前环境与版本基线
进入项目根目录，执行php think version，输出必须为v6.x.x格式；若显示v5.1.x，说明尚未完成6.0迁移，需先补全这一步再谈8.0。
紧接着分别验证CLI与Web SAPI的PHP版本是否统一且≥8.1.0：在终端运行php -v，同时新建info.php写入<?php phpinfo(); ?>并用浏览器访问——两者必须同时满足PHP 8.1.0 或更高版本，否则构造函数属性提升、联合类型等语法将直接导致解析失败。
检查必需扩展是否启用：mbstring、openssl、pdo_mysql、json、curl缺一不可，可用php -m | grep -E 'mbstring|openssl|pdo'快速筛查。
立即学习“PHP免费学习笔记（深入）”；
创建TP8基准项目用于精准比对
在空目录执行composer create-project topthink/think tp8-base，安装完成后进入tp8-base目录，用ls -la观察结构——你会看到app/、config/、runtime/，但没有application/目录。
打开tp8-base/composer.json，重点抄下这三行：
"topthink/framework": "^8.0"
"topthink/think-orm": "^3.0"
"topthink/think-filesystem": "^2.0"
这个新项目就是你的“黄金标尺”，后续每一步都要回来对照文件位置、类引用路径和配置加载方式。
这一步操作起来很简单，直接把命令复制粘贴执行就行。
执行核心依赖替换与锁文件清理
方法一：手动编辑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等官方包也需同步查文档确认是否需升级主版本。
方法二：使用参考项目比对
用tp8-base/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]。
第四步：修正模型字段限制写法
将$this->field('id,name')->select()替换为$this->field(['id','name'])->select()；think-orm 3.0的field()方法不再接受字符串参数，传入字符串会静默忽略字段限制，导致全字段查询泄露敏感数据。
更新后强制清除缓存并重跑优化
① 执行php think clear——清除所有缓存（包括模板、日志、配置）
② 执行php think optimize:schema——重新生成ORM模型结构缓存（尤其重要：V8.0.1之前此命令在子目录模型下会crash，更新后必须重跑）
③ 删除整个runtime/目录——缓存残留常导致路由404、配置读取失败，这一步不能跳过。
