# 修复 WordPress 白屏死机问题

Source: https://support.kapsulehost.com/zh-cn/wordpress-white-screen

"白屏死机"是指您的WordPress网站显示一个空白的白色页面,且没有任何错误信息。这是WordPress较为棘手的问题之一,因为它没有提供任何关于原因的直观线索。本指南将逐一介绍最常见的原因以及相应的解决方法。

### 第1步:检查错误日志

首先要做的是检查您的PHP错误日志,它通常会揭示确切的原因:

1. 登录KPanel,网址为[kpanel.kapsulehost.com](https://kpanel.kapsulehost.com)
2. 进入**网站**,选择您的网站,然后点击**日志**
3. 打开**PHP 错误日志**
4. 查找白屏开始出现时间附近的`Fatal error`条目

更多详情请参阅[查看您的网站错误日志](https://support.kapsulehost.com/zh-cn/error-logs)。

### 第2步:启用WordPress调试模式

如果错误日志未能显示足够的详细信息,请启用WordPress调试模式:

1. 通过SFTP或KPanel文件管理器进行连接
2. 打开`wp-config.php`
3. 设置以下内容:

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

4. 重新加载页面,然后查看`wp-content/debug.log`中的错误信息

### 第3步:停用所有插件

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

如果您能够访问WordPress管理后台:进入**Plugins > Installed Plugins**,全选,然后在批量操作菜单中选择**Deactivate**。

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

1. 通过[SFTP](https://support.kapsulehost.com/zh-cn/sftp-access)连接到您的网站
2. 导航至`wp-content/plugins/`
3. 将`plugins`文件夹重命名为`plugins-disabled`
4. 尝试重新加载网站

如果白屏问题消失,说明问题出在某个插件上。将文件夹重命名回`plugins`,然后逐一停用插件,直至找出引发问题的插件。

### 第4步:切换至默认主题

出现故障的主题同样可能导致白屏:

1. 通过SFTP进入`wp-content/themes/`
2. 将您当前使用的主题文件夹重命名为类似`mytheme-disabled`的名称
3. WordPress将自动回退至默认主题

> **Tip:** 在确定存在问题的插件或主题后,请检查开发者是否提供了可用的更新。许多白屏问题会在下一个版本中得到修复。

### 第5步:提高PHP内存限制

当WordPress[内存耗尽](https://support.kapsulehost.com/zh-cn/wordpress-memory-limit)时,可能会出现白屏。要提高限制:

1. 在文件管理器中或通过SFTP打开`wp-config.php`
2. 在`/* That's all, stop editing! */`这一行之前添加以下这行内容:

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

3. 保存文件并重新加载网站

您也可以在KPanel中的**Websites > [您的网站] > Settings > PHP**下提高PHP内存限制。

### 第6步:从备份恢复

如果以上所有步骤均无法解决问题,从问题发生前创建的备份进行恢复是最快的解决方案。请参阅[从备份恢复](https://support.kapsulehost.com/zh-cn/restoring-from-backup)。

### 问题仍未解决?

如果在完成以上步骤后白屏问题依然存在,请在KPanel的**支持**下提交支持工单。请附上最近的PHP错误日志条目,以及问题出现前网站所做更改的说明。