ThinkPHP升级后白屏需直击PHP原始报错：第一步在public/index.php顶部插入error_reporting(E_ALL);ini_set('display_errors','1');ini_set('display_startup_errors','1')；第二步检查vendor/autoload.php是否存在；第三步确保APP_ENV=dev且.env在项目根目录；第四步禁用think\initializer\Error::register()；第五步确认PHP≥8.1并启用opcache、mbstring等扩展。
升级ThinkPHP版本后项目启动就白屏，说明框架加载过程在某处被中断且错误未暴露——可能是新版本语法不兼容、自动加载路径变更、核心类重命名或错误处理器行为突变，必须绕过框架封装直击PHP原始报错。
第一步：强制触发PHP原生错误显示
在public/index.php最顶部（任何require或include之前）插入三行诊断代码：
error_reporting(E_ALL);
ini_set('display_errors', '1');
ini_set('display_startup_errors', '1');
这一步必须放在第一行，否则框架初始化失败时的Parse error根本不会执行到后续代码。如果升级后连入口文件语法都出错（比如TP8用了PHP8.1特性但服务器是8.0），只有这里能捕获。
立即学习“PHP免费学习笔记（深入）”；
第二步：验证vendor/autoload.php是否可加载
在上一步代码下方紧接添加：
die(file_exists(__DIR__.'/../vendor/autoload.php') ? 'autoload OK' : 'autoload missing');
TP6+和TP8启动第一步就是加载Composer自动加载器，若此文件不存在或权限不足（如chmod 600 vendor/autoload.php），直接500白屏且无任何提示。Linux下需确保www用户对vendor/有r-x权限，执行chmod -R 755 vendor即可。
第三步：检查APP_ENV与APP_DEBUG生效顺序
ThinkPHP 6.1+起，APP_ENV优先级高于APP_DEBUG：若.env中APP_ENV=prod，即使APP_DEBUG=true也强制关闭调试。
① 确认.env文件位于项目根目录（与app/、config/同级），不是public/下；
② 检查.env内容是否为APP_ENV=dev
③ 删除runtime/目录强制重建缓存——旧runtime可能残留TP旧版本的配置缓存，导致新版本读取错误配置；
④ 在public/index.php顶部加一行：var_dump($_ENV['APP_ENV'] ?? 'not set'); exit; 验证环境变量是否真被加载。
【APP_ENV必须设为dev，且.env必须放在项目根目录】
第四步：禁用ThinkPHP异常拦截器
方法一：临时注释掉public/index.php中think\initializer\Error::register()调用
方法二：在config/app.php中将'exception_handle' => \think\exception\Handle::class改为'exception_handle' => null
TP8重构了异常处理机制，默认只捕获继承think\Exception的异常，原生Exception会被PHP底层直接终止脚本——而升级时常见第三方库抛出原生异常，此时框架拦截器失效，错误静默消失。关掉它才能看到真实报错堆栈。
第五步：确认PHP版本与扩展兼容性
TP8要求PHP ≥ 8.1，若服务器仍为8.0，vendor/autoload.php加载阶段就会因语法错误（如枚举类型声明）直接崩溃。
执行php -v确认CLI版本，再通过phpinfo()页面核对Web SAPI的PHP版本——两者可能不一致；
检查php.ini中是否禁用了TP8必需扩展：opcache（必须启用）、mbstring、intl、json；
若使用宝塔，需进入「PHP版本」→「设置」→「禁用函数」列表，确认proc_open、shell_exec未被禁用（TP8部分命令行功能依赖它们）。
