先用PHPCompatibility工具扫描ERROR级问题，再重点处理mysql_*函数删除、类型提示引发的TypeError、opcache注解失效及第三方包兼容性。
老项目迁移到新版 PHP 不是“换版本”就能完事，而是要先看清哪些地方会直接报错、哪些只是日志刷屏但能跑，再决定改代码还是换依赖。
怎么快速定位兼容性雷区
别急着改代码，先用工具扫一遍真实问题。PHPCompatibility 是目前最准的静态检查工具，它能直接告诉你哪行用了 mysql_connect()、哪个 each() 调用在 PHP 8.2 下已失效。
- 安装后运行：
vendor/bin/phpcs -ps . --standard=PHPCompatibility --runtime-set testVersion 8.2，只看 ERROR 级别输出，优先处理这些 - 如果项目用了 ThinkPHP 5.1，
phpcs可能漏掉反射注解失效问题——得额外检查opcache.save_comments=0是否被设为 0（PHP.ini 中），否则@param string $id这类注解会白写 - 注意：工具不会发现
array_key_exists(null, [])在 PHP 8.0+ 返回false（旧版返回true）这类隐式行为变更，这种得靠单元测试覆盖关键路径
哪些函数必须立刻替换
PHP 8 彻底移除了 mysql_* 函数族，不是“弃用”，是“删了”。只要代码里还存在 mysql_connect() 或 mysql_query()，启动即 Fatal error。
- 全局搜索：
grep -r "mysql_\|create_function\|each(" app/ extend/，一个都不能留 -
create_function()必须换成匿名函数，例如create_function('$a', 'return $a * 2;')→fn($a) => $a * 2（PHP 7.4+）或function($a) { return $a * 2; } -
each()不是简单替换成foreach就完事——旧逻辑里常配合list()解构，而list()在 PHP 8.0+ 对非数组输入抛TypeError，得一并检查list($k, $v) = each($arr)这类写法
ThinkPHP 类框架项目最容易卡在哪
ThinkPHP 5.0/5.1 在 PHP 8 下不是“不兼容”，而是“类型校验变严”触发连锁反应：控制器方法声明 string $id，但 URL 没传 id 参数时，旧版自动给 null，PHP 8 直接 Fatal error: Uncaught TypeError。
立即学习“PHP免费学习笔记（深入）”；
- 临时解法：把所有控制器方法参数类型提示全去掉，比如
public function detail(string $id)→public function detail($id)，后续用$this->request->param('id', '', 'htmlspecialchars')做业务层校验 - Facade 静态门面（如
Cache::get()）在 PHP 8.1+ 报Deprecated: Return type，是因为__callStatic没声明返回类型；补: mixed最省事，但更推荐改用依赖注入：app('cache')->get('key') - 第三方扩展包（如
topthink/think-captcha）大概率没更新，composer update仍会装上——得手动在composer.json加"conflict": {"topthink/think-captcha": " 锁死旧版，或找替代方案
配置和扩展不能只改 php.ini
很多迁移失败不是代码问题，是扩展没对上号。PHP 8 移除了 mcrypt、mysql 扩展，php -m 输出里看不到，但旧配置里还留着 extension=mcrypt.so，PHP 启动会警告甚至拒绝加载其他模块。
- 执行
php --ini确认实际加载的php.ini路径，然后逐行检查extension=行，删掉所有已移除扩展的加载项 -
date.timezone在 php.ini 中必须显式设置，PHP 8 不再容忍未配置——否则date()、strtotime()全部警告 - OPcache 开启后，
opcache.revalidate_freq=0和opcache.validate_timestamps=Off在开发环境要关掉，否则改了代码不生效，误以为是迁移问题
真正麻烦的从来不是“哪里要改”，而是“改完之后，有没有漏掉某个角落里的 mysql_*() 调用，或者某个 Composer 包悄悄带进来的 each() 用法”。上线前至少跑一次完整业务流程，别只信自动化扫描结果。
