ThinkPHP 6.0 升级至 8.0 并非无缝：需确保 PHP≥8.0.0（CLI 与 Web SAPI 一致）、启用关键扩展、替换 composer.json 依赖、删除 vendor 和 lock 后全量更新、清空 runtime、适配 Request/路由/自动加载变更，并检查第三方包兼容性。
直接从 ThinkPHP 6.0 升级到 8.0 不可能“无缝”——所谓“无缝”是官方宣传口径，实际项目中必然涉及 PHP 版本跃迁、依赖冲突、废弃 API 替换和目录结构调整。跳过验证步骤强行 composer update，90% 的项目会在 Class 'think\App' not found 或路由白屏时卡死。
确认 PHP 版本与 SAPI 一致性
ThinkPHP 8.0 强制要求 PHP >= 8.0.0，但很多开发者只检查了 CLI 的 php -v，却忽略了 Web SAPI（如 php-fpm）仍运行在 PHP 7.4 上。这种不一致会导致 composer update 成功、浏览器访问直接 500 错误。
- 执行
php -v查 CLI 版本 - 在 Web 环境下访问
phpinfo()或运行php -r "echo PHP_SAPI;"确认 SAPI 类型及版本 - 关键扩展必须启用：
mbstring、openssl、pdo_mysql、json、curl - 若用 Docker，建议统一使用
php:8.2-apache或php:8.1-fpm镜像，避免环境漂移
替换 composer.json 并强制解析全部依赖
不能只改 "topthink/framework": "^6.0" 为 "^8.0" 就跑命令。TP8 的核心依赖已拆分为独立包，且对子依赖（如 psr/log、monolog/monolog）版本更敏感。
- 参考全新 TP8 项目生成的
composer.json，至少同步以下几项："php": ">=8.0.0""topthink/framework": "^8.0""topthink/think-orm": "^3.0""topthink/think-filesystem": "^2.0" - 执行
composer update topthink/framework --with-all-dependencies，而非--with-dependencies（后者不递归解决间接依赖） - 若报
Your requirements could not be resolved，说明某第三方包锁死了旧版psr/container或symfony/polyfill，需手动升级或替换该包 - 升级前删掉
composer.lock和vendor/，避免缓存干扰解析
清理 runtime 并适配关键代码变更
TP8 不会自动清除旧缓存，残留的 runtime/cache/、runtime/route.php 会继续加载 TP6 的路由规则，导致新 app/Route.php 完全不生效。
立即学习“PHP免费学习笔记（深入）”；
- 升级后第一件事：彻底删除整个
runtime/目录 -
Request::instance()已废弃，统一改为think\facade\Request或构造函数注入think\Request - 路由文件从
route/route.php迁移到app/Route.php，且语法需调整：
旧写法：Route::get('user', 'index/user/index')
新写法推荐：Route::get('user', [app\controller\User::class, 'index']) - 自定义的
app/common.php不再自动加载，如需全局函数，应移至app/Helper.php并确保其被 Composer 的autoload.files声明
检查第三方包是否仍在维护
很多 TP6 时代活跃的扩展（如 topthink/think-swoole、topthink/think-multi-app）在 TP8 中已被官方弃用，而社区包（如某些支付 SDK）可能两年未更新，内部仍调用 think\App 或 think\Config 等已移除类。
- 运行
composer show --tree，逐层检查每个包是否声明了"conflict": {"topthink/framework": " 或兼容性提示 - 重点排查业务强依赖包：
alipaysdk/easysdk、wechatpay/wechatpay、overtrue/laravel-wechat（非 TP 原生）等 - 临时方案：用
composer require --dev phpstan/phpstan扫描代码中所有new \think\实例化，快速定位硬编码引用 - 没有维护的包，不要强行降级依赖来“凑合”，应尽快替换为原生实现或轻量封装
最易被忽略的一点：TP8 的 think-orm v3.0 默认关闭了模型事件的自动触发（如 saving、saved），如果你的业务逻辑重度依赖这些钩子，必须显式调用 Model::observe() 或在模型中启用 protected $event = true;。这个开关不报错、不警告，只默默失效。
