核心原因是PHP升级后配置断层、扩展缺失或权限错位；需立即验证PHP-FPM进程是否就绪、扩展是否真实加载、runtime及日志目录权限是否为www:www且755、并在入口文件首行插入error_reporting(E_ALL);ini_set('display_errors','1');强制暴露错误。
小皮面板升级 PHP 后网站白屏并返回 500 错误，核心原因是环境变更触发了配置断层、扩展缺失或权限错位——不是代码突然坏了，而是新 PHP 版本“不认识”旧环境。重点不是回退版本，而是快速对齐运行条件。
立刻验证 PHP 是否真正就绪
升级后 PHP-FPM 进程未必自动重启，或新版本未被 Web 服务正确调用：
- 在小皮面板「PHP管理」页确认目标版本状态为“已启动”，并点击右侧“重载配置”
- 终端执行 ps aux | grep php-fpm，检查进程显示的 PHP 路径是否匹配你升级的版本（如
/www/server/php/82） - 新建一个
info.php放到网站根目录，内容仅一行：<?php phpinfo(); ?>，直接访问它。若也 500，说明是环境级问题；若能打开，问题出在你的项目本身
检查扩展与依赖是否跟上
PHP 升级常导致扩展失效——小皮面板勾选扩展 ≠ 实际加载成功：
- 打开小皮面板「PHP扩展管理」，确认项目所需扩展（如
pdo_mysql、curl、openssl、mbstring）已勾选且状态为“已安装” - 在
info.php页面搜索关键词，确认扩展名出现在“Loaded Extensions”列表中；若缺失，返回扩展页点击“安装”，再点“重载” - ThinkPHP 类项目还需检查 Composer 自动加载：进入项目根目录，运行 composer dump-autoload（确保 Composer 已适配新 PHP 版本）
修复权限与日志写入路径
小皮默认用 www 用户运行 PHP-FPM，升级后常见权限继承错乱，尤其 runtime/log 和错误日志目录：
立即学习“PHP免费学习笔记（深入）”；
- 确认项目
runtime/目录（ThinkPHP）或storage/（Laravel）属主为www:www，权限为755：chown -R www:www /www/wwwroot/your-site/runtime - 检查 PHP 错误日志路径：执行 php -i | grep error_log，获取实际路径（如
/www/wwwlogs/php_error.log）；确认该文件存在且可写：touch /www/wwwlogs/php_error.log && chown www:www /www/wwwlogs/php_error.log - 刷新页面后立即执行 tail -f /www/wwwlogs/php_error.log，看是否有新错误行（重点关注
Parse error、Fatal error、Class not found）
临时强制暴露原始错误
绕过所有配置屏蔽，让错误直接打到浏览器（仅限排查，勿留在线上）：
- 打开项目入口文件（如 ThinkPHP 的
public/index.php或普通 PHP 站点的index.php） - 在第一行
<?php后**紧贴着**插入两行（前面不能有空格、BOM 或换行）：error_reporting(E_ALL);ini_set('display_errors', '1'); - 保存并刷新，若出现红色报错，按提示修复（常见如函数废弃：
mysql_connect()在 PHP 8+ 不可用；或语法升级：match表达式需 PHP 8.0+）
