ThinkPHP5.0/5.1在PHP8下需适配TypeError、Facade返回类型、MySQL驱动移除及扩展包兼容性问题：应降级类型提示、补全__callStatic返回类型、改用PDO/mysqli、升级扩展包并开启错误显示排查。
PHP8的TypeError报错让ThinkPHP5.0/5.1直接挂掉
旧版ThinkPHP（尤其是5.0.x和5.1.x）大量使用func_get_args()配合可变参数模拟重载，而PHP8严格校验函数签名——当控制器方法声明了类型提示（如string $name），但实际传入null或未传参时，PHP8不再静默转为默认值，而是抛出TypeError。这不是ThinkPHP的bug，是PHP8的语义变更。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 逐个检查
app\controller\*下所有方法签名，把string $id这类强类型提示临时改为$id（留待后续业务层校验） - 禁用
opcache.save_comments=0（PHP.ini中），否则ThinkPHP的反射注解（如@param string）会失效，导致路由解析异常 - 升级到
thinkphp5.1.40+（官方最低兼容PHP8的版本），它修复了Request::param()对null返回值的处理逻辑
ThinkPHP5.1的Facade在PHP8.1+报Deprecated: Return type
PHP8.1引入返回类型声明强制校验，而ThinkPHP5.1中大量Facade类（如Cache、Log）的__callStatic方法没声明返回类型，触发弃用警告。这不会中断运行，但日志刷屏且影响调试效率。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在
thinkphp/library/think/facade/对应类里，给__callStatic补上: mixed（PHP8.0+支持）或: void（若确定无返回） - 更稳妥的做法：改用依赖注入，例如把
Cache::get('key')换成app('cache')->get('key')，避开静态门面 - 确认
composer.json中"php": "^7.2 || ^8.0"已更新，否则composer update可能跳过PHP8适配包
mysql_connect()被移除导致Db类初始化失败
PHP8彻底删除了已被废弃十多年的mysql_connect()及其相关函数。虽然ThinkPHP默认用PDO，但部分老项目在database.php里仍残留'type' => 'mysql'却没配'pdo' => true，或自定义了基于mysql_*的扩展驱动，启动时直接Fatal error。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 检查
config/database.php，确保'type'是'pdo'或'mysqli'，绝不能是'mysql' - 搜索整个项目：
grep -r "mysql_connect\|mysql_query" app/ extend/，删掉所有mysql_*调用，替换为Db::query()或PDO原生写法 - 如果必须保留MySQLi连接池逻辑，需重写
think\db\connector\Mysql的connect()方法，用mysqli_connect()替代
第三方扩展包（如topthink/think-captcha）不兼容PHP8
很多TP生态扩展包最后一次更新在2019年前，其composer.json里"php": ">=5.6.0"没约束上限，Composer会照常安装，但运行时因PHP8语法变更（如array_key_exists(null, [])返回false而非true）崩溃。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 优先找维护者更新版：例如验证码包应升至
think-captcha 3.0.10+（支持PHP8） - 若无更新，临时方案是在
vendor/对应包目录下手动修改src/Captcha.php，把array_key_exists($key, $arr)前加is_scalar($key) &&防护 - 用
composer why-not php:8.0定位阻塞包，比盲目升级更高效
迁移中最容易被忽略的是error_reporting级别——PHP8默认开启E_DEPRECATED，而旧项目往往靠@抑制错误，这些被掩盖的问题会在PHP8里暴露为Warning甚至Error。别只盯着Fatal error，得把display_errors=On开着跑完整业务流。
