应立即回退Composer依赖或恢复Nginx伪静态配置：先查composer.lock中旧版本号并执行composer require topthink/framework:旧版本 --with-all-dependencies，再清空runtime；若仍异常，则注释Nginx重写规则并测试/index.php路由。
新手升级ThinkPHP版本失败后，框架报错、路由失效、页面空白或500错误频发，急需立刻恢复到升级前可用状态——这不是等待调试或重读文档的时候，而是必须用可验证的最小操作集切断问题源头、还原运行环境。
确认当前框架版本与失败动作
执行 php think version 查看实际加载的框架版本，输出形如 ThinkPHP v6.1.0 或 v8.0.3；若命令报错，说明 autoloader 已断裂，跳过此步直接进入 Composer 回退。
回忆你执行过的升级命令：是 composer update 全量更新？还是 composer require topthink/framework:^8.0 单独升级核心？或是手动覆盖了 vendor 目录？【不同动作对应不同回退路径，混用将导致依赖锁死】
Composer 依赖回退（最常用场景）
方法一：回退到已知稳定版本（推荐）
立即学习“PHP免费学习笔记（深入）”；
第一步：查出升级前的版本号——打开项目根目录下的 composer.lock 文件，搜索 "topthink/framework"，找到紧邻 upgrade 操作前的 "version" 字段值，例如 "6.0.12"。
第二步：执行降级命令：composer require topthink/framework:6.0.12 --with-all-dependencies。这会强制重装该版本及其所有兼容子依赖，【不加 --with-all-dependencies 可能残留高版本子包，导致类找不到或方法不存在】。
第三步：删除 runtime/ 目录全部内容，清空缓存干扰。
方法二：彻底撤销本次 composer update
运行 composer install ——它会严格按 composer.lock 中记录的旧版本重新安装所有包，无需指定版本号。这比 require 更干净，尤其当你记不清原版本时。
伪静态配置错误导致无法访问入口
先别碰代码，立刻停用重写逻辑：进宝塔 → 网站 → 设置 → 配置文件，找到 location / { ... } 块，整段用 # 注释掉，或替换为最简兜底规则：
location / { try_files $uri $uri/ /index.php?$query_string; }
然后执行 nginx -t && systemctl reload nginx。这一步能绕过所有 if 判断和 rewrite 循环，让请求直达 index.php。
打开浏览器，直接访问 http://your-domain.com/index.php/user/login（或 /public/index.php/user/login），若页面正常加载，证明框架本身无损，问题纯属 Nginx 配置层；若仍 500，说明 PHP 环境或 runtime 权限出错，需检查 error_log。
路由注册失效或 Route::get 报错
TP6+ 路由必须在 app/route.php 中返回 RuleGroup 实例，不能放在控制器或中间件里调用 Route::get。
检查文件是否存在且路径正确：app/route.php（不是 route/app.php 或 route/route.php）；
确认文件开头有 use think\facade\Route;，结尾是 return Route::group(...); 或类似有效返回语句；
若文件被误删或内容为空，从备份中恢复该文件，或临时创建一个最简版：
<?php use think\facade\Route; return Route::get('test', function () { return 'ok'; });
数据库迁移状态错乱导致 rollback 失效
运行 php think migrate:rollback 无反应或报错，先检查 database/migrations/ 目录下是否有带时间戳的迁移文件（如 20230101000000_create_user_table.php），且每个文件内含完整的 up() 和 down() 方法。
连接数据库，查 think_migration 表是否存在、是否有记录；若表为空或根本不存在，说明迁移从未真正执行过，rollback 自然无效——此时不要强行运行 rollback，直接删掉该表（如果存在）再重建，或手动执行 down() 中的 SQL。
迁移文件本身不可逆，【down() 方法若漏写 DROP INDEX 或未处理外键，回滚后表结构将残缺，后续升级必报错】。
