修复 WordPress 白屏死机问题

The "white screen of death" is when your WordPress site displays a blank white page with no error message. It is one of the more frustrating WordPress issues because it gives no visible clue about…

"白屏死机"是指 WordPress 网站显示空白白页且没有错误信息。这是比较令人沮丧的 WordPress 问题之一，因为它不会给出任何可见的问题线索。本指南介绍了最常见的原因及各自的修复方法。

第 1 步：检查错误日志

首先要检查 PHP 错误日志，它通常会显示确切的原因：

登录 KPanel（网址为 kpanel.kapsulehost.com）
进入网站，选择您的网站，然后点击日志
打开 PHP 错误日志
查找白屏出现时间附近的 Fatal error 条目

详细信息请参考访问网站错误日志。

第 2 步：启用 WordPress 调试模式

如果错误日志没有显示足够的详细信息，请启用 WordPress 调试模式：

通过 SFTP 或 KPanel 文件管理器连接
打开 wp-config.php
设置以下内容：

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

重新加载页面并检查 wp-content/debug.log 中的错误信息

第 3 步：停用所有插件

有故障或不兼容的插件是更新后出现白屏的最常见原因。

如果您能访问 WordPress 管理后台：进入插件 > 已安装的插件，全选所有插件，然后在批量操作菜单中选择停用。

如果您无法访问 WordPress 管理后台：

通过 SFTP 连接到您的网站
导航到 wp-content/plugins/
将 plugins 文件夹重命名为 plugins-disabled
尝试加载网站

如果白屏消失，说明插件是元凶。将文件夹重命名回 plugins，然后逐个停用插件，直到找到有问题的插件。

第 4 步：切换到默认主题

损坏的主题也可能导致白屏：

通过 SFTP 进入 wp-content/themes/
将活跃主题的文件夹重命名为类似 mytheme-disabled 的名称
WordPress 将回退到默认主题

识别出有问题的插件或主题后，检查开发者是否发布了更新。许多白屏问题在下一个版本中已修复。

第 5 步：增加 PHP 内存限制

当 WordPress 内存不足时可能会出现白屏。要增加内存限制：

通过文件管理器或 SFTP 打开 wp-config.php
在 /* That's all, stop editing! */ 行之前添加以下行：

define( 'WP_MEMORY_LIMIT', '256M' );

保存文件并重新加载网站

您也可以在 KPanel 中的网站 > [您的网站] > PHP 设置下增加 PHP 内存限制。

第 6 步：从备份恢复

如果以上步骤都不能解决问题，从问题出现前的备份进行恢复是最快的解决方案。请参考从备份恢复。

仍未解决？

如果在按照这些步骤操作后白屏问题仍然存在，请在 KPanel 中的支持下开启支持工单。请包含最近的 PHP 错误日志条目和问题出现前网站有何更改的描述。