← 返回帮助中心部署问题

PHP 页面白屏或返回 500 怎么排查

从错误日志、PHP 版本、扩展、权限和入口文件定位白屏或 HTTP 500。

先不要反复刷新

白屏通常是 PHP 致命错误但生产环境关闭了错误显示。先查看宝塔“网站日志”和对应 PHP 版本的错误日志。

排查顺序

确认网站选择的 PHP 版本与源码要求一致。
执行 php -l 文件.php 检查最近修改文件。
检查 PDO MySQL、OpenSSL、Sodium、cURL、fileinfo、mbstring、ZipArchive 等扩展。
确认网站目录、storage、uploads 和日志目录权限。
检查数据库配置、表名和字段是否已经执行升级 SQL。

生产环境要求

不要长期开启 display_errors。修复后关闭公开错误显示，只在服务器日志中记录异常。