ThinkPHP8项目在PHP8下报TypeError主因是strict_types=1启用后暴露松散写法：需逐文件检查declare(strict_types=1)并修复count()判空、implode()强制(array)转换、函数返回类型补?标识及Facade返回类型声明。
ThinkPHP8项目在PHP8环境下运行时突然报出大量TypeError，比如count()传入null、implode()第二参数不是数组、函数返回值与声明不匹配——这些错误不是代码写错了，而是PHP8的严格类型校验把长期被忽略的松散写法直接拦截了。
确认是否启用了strict_types=1
打开所有报错控制器、模型、服务类的PHP文件头部，检查第一行是否为declare(strict_types=1);。若存在且项目含大量未声明类型的旧方法，这就是冲突根源。
临时注释掉该声明：// declare(strict_types=1);，再刷新页面。如果TypeError消失，说明问题确由严格模式触发——但【不能长期禁用，必须逐个修复】。
注意：strict_types只对当前文件生效，子文件不会继承。所以要挨个检查app/controller/、app/model/下每个PHP文件。
立即学习“PHP免费学习笔记（深入）”；
修复count()和implode()的参数类型风险
方法一：对count()加判空+类型校验
把所有count($data)替换为is_array($data) ? count($data) : 0。不要用!empty($data)替代，因为empty([''])返回true，而count([''])是1，语义不同。
方法二：对implode()强制兜底为数组
将implode(',', $list)改为implode(',', (array)$list)。这一步操作起来很简单，直接在变量前加(array)强制转换即可，能覆盖null、string、object等所有非数组输入。
方法三：定位源头数据生成逻辑
常见陷阱是数据库查询未执行->select()就直接传给count()，例如$users = User::where('status', 1); count($users);——这在TP8里$users是Query对象，不是数组。必须先调用$users->select()或$users->count()。
处理函数返回值类型声明冲突
第一步：找出所有声明了返回类型的函数
用grep命令全局搜索：grep -r "):[a-z]*|):\?" app/ --include="*.php" | grep -v "void|mixed"，重点排查返回string/int/bool/array但实际可能返回null的函数。
第二步：补全null安全判断
例如原函数function getName(): string { return $this->name; }，若$this->name可能为null，必须改为function getName(): ?string { return $this->name; }——【?string是PHP7.1+语法，TP8完全支持，且比空字符串兜底更语义准确】。
第三步：检查魔术方法返回类型
__get()、__call()等魔术方法若被声明了返回类型（如public function __get(string $name): string），但实际属性不存在时返回null，就会爆TypeError。必须全部改为: ?string或: mixed。
绕过Facade静态调用的返回类型警告
ThinkPHP8的Cache::get()、Log::info()等门面方法在PHP8.1+会触发Deprecated警告，因其__callStatic未声明返回类型。
方法一：临时关闭报错显示（仅开发环境）
在public/index.php顶部添加error_reporting(E_ALL ^ E_DEPRECATED);，但这只是掩盖问题，不能解决。
方法二：改用依赖注入替代静态调用
将Cache::get('token')替换为app('cache')->get('token')。这一步不需要改配置，app()函数在TP8中始终可用，且返回对象的方法都有完整类型声明。
方法三：手动补全Facade返回类型（需修改vendor）
打开thinkphp/library/think/facade/Cache.php，在__callStatic方法末尾加上: mixed，保存后运行composer dump-autoload重载类映射。
