必须逐个确认第三方扩展包是否真正支持TP8，否则升级后将导致支付、短信、登录等功能崩溃；需先生成依赖树、锁定高危包核查兼容性、扫描废弃调用、搭建Docker验证环境并完成五项最终检查。
要让ThinkPHP 6.0项目在升级到8.0后不因第三方扩展包崩溃，必须在改composer.json前逐个确认每个包是否真正支持TP8——跳过这步直接update，轻则白屏报错，重则支付、短信、登录全部失效。
第一步：生成当前项目完整依赖图谱
进入项目根目录（确保该目录下存在composer.json和think可执行文件），运行：
composer show --tree
这一步输出的是你项目的“真实血缘关系”，不是composer.json里写的表面依赖。很多崩溃根源藏在二级、三级依赖里，比如你只装了alipay/easysdk，但它悄悄拉进了psr/http-message v1.0，而TP8强制要求v2.0以上。不看树状图，你永远不知道哪条支线会断。
把输出结果保存为deps-tree-6.0.txt，后面每轮验证都要比对。
立即学习“PHP免费学习笔记（深入）”；
第二步：锁定三类高危包并逐个核查
方法一：官方生态包（必须查GitHub最新release）
重点盯紧topthink/think-orm、topthink/think-filesystem、topthink/think-swoole。其中think-swoole在TP8中已废弃，【必须替换为topthink/think-swoole-v8或改用Swoole原生协程】；think-orm从v3起才正式支持TP8，若你当前用的是v2.x，必须升到v3.0+。
方法二：社区热门扩展（查packagist.org的“Supported by”和“Abandoned”标识）
验证码（topthink/think-captcha）、JWT（firebase/php-jwt或tymon/jwt-auth）、Excel导出（phpoffice/phpspreadsheet）——注意tymon/jwt-auth最新稳定版仅兼容TP6，【TP8需改用lcobucci/jwt + 自定义中间件】；phpspreadsheet本身无框架绑定，但它的某些旧版本调用的ReflectionClass::getDocComment()在PHP 8.1+已被弃用，需升至v1.28.0+。
方法三：业务强依赖SDK（必须查服务商文档+测试沙箱）
微信支付v3 SDK（wechatpay/wechatpay-php）、阿里云OSS（aliyun/oss-sdk-php）、极光推送（jpush/jpush）——这些包往往不声明tp版本兼容性，唯一验证方式是：新建空TP8项目→require该SDK→跑通一个最简API调用（如上传空文件、发一条测试消息）。别信README里的“兼容所有ThinkPHP”，去年某金融项目就因aliyun/oss-sdk-php的Signer类在TP8的Request对象里拿不到rawContent而卡死3天。
第三步：用脚本扫描代码中已废弃的调用痕迹
① 扫描全局函数残留：
grep -rn "dump\|halt\|p\|show_error" ./app ./common ./extend
在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...
② 扫描静态单例调用（TP8已移除）：
grep -rn "Request::instance()\|App::instance()\|Cookie::instance()" ./app
③ 扫描application/目录引用（TP8彻底删除该目录结构）：
grep -rn "application/" ./app ./config ./route
这三步必须在升级前完成。一旦runtime/缓存未清，即使你改了代码，TP8仍可能加载旧版application/common.php中的dump函数定义，导致Fatal error: Cannot redeclare dump()。每次扫描后，把发现的行号和文件路径记入upgrade-risk.csv，升级后逐条回归验证。
第四步：创建最小化兼容验证环境
用docker快速起一个干净TP8环境：
docker run --rm -v $(pwd):/app -w /app php:8.2-apache composer install
这行命令会强制用PHP 8.2+和干净扩展集重新安装依赖，绕过本地环境干扰。如果它失败，说明你的composer.json里有硬冲突包——此时不要硬改，先去GitHub搜那个包名+“thinkphp8”，90%的case都能找到社区补丁分支（比如monolog/monolog#3422就有TP8适配PR）。
验证通过后，删掉容器，保留这个镜像作为后续CI流程的基础镜像。
第五步：执行升级前最后检查
运行php think version确认当前确实是6.x版本；
运行php -v确认CLI PHP版本≥8.0.0；
运行php -m | grep -E "mbstring|openssl|pdo|json|curl"确认扩展全启用；
打开composer.lock，搜索"topthink/framework"，确认其version字段以"6."开头。
全部通过，才能进行下一步composer.json修改操作。
