ThinkPHP 6.0 迁移 PHP 8.1 报错核心是版本过低（需 ≥6.0.10）、代码未适配类型严格性（如 null 被当数组用）、CLI 与 Web PHP 版本不一致、扩展缺失或缓存未清理。
ThinkPHP 6.0 项目迁移到 PHP 8.1 环境报兼容错误，核心问题不是框架本身“不能跑”，而是你用的 TP 版本太旧、代码写法松散、或依赖未对齐。只要版本达标（≥6.0.10）且代码稍作适配，就能稳定运行。
先确认你的 TP 版本是否真正支持 PHP 8.1
运行命令：
php think version composer show topthink/framework
如果显示 v6.0.9 或更早，必须升级——这些版本未修复 PHP 8.1 的类型校验逻辑，会直接报 TypeError: count(): Argument #1 must be of type Countable|array, null given 这类致命错误。
✅ 正确做法：升级到 v6.0.10 或更高（如 v6.1.4、v6.2.3），它是官方认证的 PHP 8.1 LTS 版本。
检查并修正三类高频报错点
-
模型关联未初始化就调用
count()或foreach
例如：$user->posts返回null（而非空集合），后续count($user->posts)在 PHP 8.1 下直接中断。
✅ 改法：统一加判空if ($user->posts && $user->posts->isNotEmpty()) { ... } // 或更稳妥： $posts = $user->posts ?? collect(); -
配置项或第三方插件返回
null，却被当数组用
常见于自定义配置文件中漏写键、config('xxx')取不到值、或get_class_vars()访问不存在静态属性。
✅ 改法：所有config()、input()、session()调用后加空值兜底$list = config('app.menu') ?: []; $data = input('post.') ?: []; -
助手函数或魔术方法缺少返回类型声明
PHP 8.1 强制要求：若方法有返回类型（如: array），就不能在某些分支里隐式返回null。
✅ 改法：补全类型提示 + 显式返回值// 错误写法（TP6.0.9 中常见） public function getStatus() { return $this->status ?: null; } // 正确写法（PHP 8.1 兼容） public function getStatus(): ?string { return $this->status; }
验证 PHP 环境是否真正一致
-
CLI 和 Web（如 php-fpm）必须用同一版 PHP：
立即学习“PHP免费学习笔记（深入）”；
php -v # CLI 版本 <?php phpinfo(); ?> # 浏览器访问，看 Web SAPI 版本
若不一致（比如 CLI 是 8.1，fpm 是 7.4），升级必然失败，首页直接 500。
-
必装扩展缺一不可：
mbstring、openssl、pdo_mysql、json、curl
快速检查：php -m | grep -E 'mbstring|openssl|pdo|json|curl'
最后一步：清缓存 & 重生成自动加载
别跳过这步，很多“改完还报错”都是缓存惹的祸：
php think clear composer dump-autoload -o
若用了 opcache，还需重启 php-fpm 或设置 opcache.revalidate_freq=0（开发阶段）。
不复杂但容易忽略
