ThinkPHP 6→8升级不能仅改版本号，必须分步验证环境（PHP≥8.5.7且CLI/Web SAPI一致）、依赖（重装vendor与composer.lock并精确指定think-orm等子包）、代码（目录结构改为app/、替换Request::instance()等废弃调用），否则易致500或白屏。
ThinkPHP 升级不是改个版本号就能跑通的事，尤其跨大版本（比如 6 → 8），必须分步验证环境、依赖和代码三者是否同步就绪，否则上线后大概率 500 或白屏。
确认 PHP 环境真实就绪
ThinkPHP 8.0+ 要求 PHP ≥ 8.0.0，且 CLI 和 Web SAPI（如 php-fpm）必须完全一致——这是最常被忽略的致命点。 - 运行 `php -v`，确认输出为 **8.5.7**（非 8.5.0、8.5.6 或其他） - 在 `public/` 下新建 `info.php`，内容为 ``，通过浏览器访问，核对顶部版本号与 CLI 一致，并确认 `Loaded Configuration File` 路径相同 - 检查必需扩展是否启用：`mbstring`、`openssl`、`pdo_mysql`、`json`、`curl`、`zip`、`fileinfo` 可用命令快速验证：`php -m | grep -E 'mbstring|openssl|pdo|curl|zip|fileinfo'` - 若使用 PHPStudy 或宝塔，请确认已切换至 **PHP 8.5.7 nts 版本**（非 ts），并重启 Apache/Nginx/php-fpm重装 TP8 全家桶，不靠 update 自动求解
TP8 对子包版本强约束，`composer update` 容易引发依赖冲突，必须显式重装： - 删除项目根目录下的 `vendor/` 和 `composer.lock` - 编辑 `composer.json`，将 `require` 区块替换为标准组合（版本号必须精确）： ```json "topthink/framework": "^8.0", "topthink/think-orm": "^3.0", "topthink/think-view": "^2.0", "topthink/think-filesystem": "^2.0" ``` - 执行 `composer install --no-dev` - 立即运行 `composer dump-autoload -o`（否则 `think` 命令和类加载会失效） - 手动删除 `runtime/` 目录（缓存残留会导致路由 404、配置读错等静默故障）调整目录结构与入口文件
TP8 彻底弃用 `application/`，统一为 `app/ + config/` 结构： - 将原 `application/` 目录重命名为 `app/`，确保其下包含 `Controller/`、`Model/`、`Middleware/`、`Route.php` 等标准子目录 - 更新 `public/index.php` 引导逻辑为 TP8 标准写法： ```php require __DIR__ . '/../vendor/autoload.php'; (new \think\App())->run()->send(); ``` - 将所有配置文件（如 `database.php`、`app.php`）移入 `config/` 目录，旧路径 `conf/` 或根目录下的配置不再生效修复废弃调用与常见兼容问题
TP8 移除大量旧接口，需逐项替换： - `Request::instance()` 已废弃，改用 `think\facade\Request` 或依赖注入 `think\Request` - 路由定义从 `route/route.php` 移至 `app/Route.php`，语法保持 `Route::get('user', 'index/user/index')` - `Db::name('user')->where(...)->select()` 仍可用，但 `Db::table('user')` 绕过模型事件，推荐优先使用模型操作 - 自定义函数若放在 `app/common.php`，TP8 默认不自动加载；请改放 `app/Helper.php` 或在 `config/app.php` 中手动注册 autoload - 检查第三方扩展（如验证码、JWT、Excel 导出包），运行 `composer show -t` 查看依赖树，确认是否支持 TP8，不维护的包需找替代方案不复杂但容易忽略
