0

0

如何解决WordPress白屏?常见错误怎么修复?

畫卷琴夢

畫卷琴夢

发布时间:2025-08-30 13:16:01

|

485人浏览过

|

来源于php中文网

原创

首先开启调试模式,通过修改wp-config.php文件添加define('WP_DEBUG', true)和define('WP_DEBUG_LOG', true),查看错误信息或debug.log日志定位问题;接着排查插件和主题冲突,无法进入后台时可通过FTP重命名plugins和themes文件夹逐一排查;最后提升PHP内存限制,在wp-config.php中设置define('WP_MEMORY_LIMIT', '256M')以解决资源不足导致的白屏问题。

如何解决wordpress白屏?常见错误怎么修复?

WordPress白屏死机(White Screen of Death,WSOD)绝对是所有站长最不想看到的情况之一。说实话,每当我看到屏幕上那一片空白,心里就咯噔一下,知道麻烦来了。但别慌,这通常不是什么世界末日,多数时候它指向的是PHP错误或者内存耗尽的问题。通常,插件冲突、主题问题、PHP内存限制不足,甚至是核心文件损坏,都可能是幕后黑手。

解决方案

面对WordPress白屏,我的经验是,首先要做的就是开启调试模式。这简直是你的救命稻草,它能把那些隐藏的PHP错误信息直接呈现在你面前,或者记录到日志文件里。你只需要编辑

wp-config.php
文件,在
/* That's all, stop editing! Happy publishing. */
这行代码之前,加入以下两行:

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

保存后刷新页面,如果能看到错误信息,那恭喜你,问题已经暴露出来了。如果依然是白屏,但你的WordPress根目录下会生成一个

wp-content/debug.log
文件,里面记录了所有的错误。

有了错误信息,通常就能对症下药了。如果错误指向某个插件或主题文件,那么很可能是它们导致的问题。这时,你需要通过FTP/SFTP访问你的网站文件,进入

wp-content/plugins
目录,尝试重命名导致问题的插件文件夹(比如
plugin-name
改成
plugin-name_old
)。或者,如果无法判断,就直接把所有插件文件夹都重命名,让WordPress认为它们不存在,这样它们就会被自动禁用。同样的方法也适用于主题,你可以进入
wp-content/themes
目录,将当前激活的主题文件夹重命名,WordPress会自动切换到默认主题(如Twenty Twenty-Four)。

如果这些操作之后网站恢复正常,那就说明问题出在被禁用的插件或主题上。你可以逐一恢复它们的名称并刷新页面,直到找到那个罪魁祸首。

另一个常见的原因是PHP内存限制不足。WordPress,尤其是运行了大量插件和复杂主题的站点,对内存的需求是挺大的。你可以在

wp-config.php
中,同样在
/* That's all, stop editing! Happy publishing. */
之前,添加或修改这一行:

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

将内存限制提高到256M或者更高,这往往能解决很多因内存不足导致的白屏。

WordPress白屏出现时,我应该从哪里着手排查?

说实话,遇到WordPress白屏,那种心里的焦躁感是真实存在的。我个人觉得,最有效率的排查起点,绝对是开启调试模式。这就像医生给病人做CT扫描,直接定位病灶。没有错误信息,你就是在大海捞针,完全凭运气。通过在

wp-config.php
中设置
WP_DEBUG
WP_DEBUG_LOG
,你就能把那些隐藏在背后的PHP错误信息揪出来。如果页面上直接显示错误,那再好不过;如果还是白屏,别忘了去
wp-content
目录下找那个
debug.log
文件,它会告诉你一切。

除了调试日志,另一个非常重要的线索来源是服务器的错误日志。很多时候,WordPress本身的调试信息可能不够全面,或者因为某些配置问题无法显示。这时候,你的主机控制面板(比如cPanel、Plesk)或者通过SSH访问服务器,查看Apache或Nginx的错误日志(通常是

error_log
),会提供更底层的PHP错误信息,比如内存溢出、PHP版本不兼容导致的致命错误等等。这往往能帮你发现一些WordPress层面无法直接捕捉到的问题。

Interior AI
Interior AI

AI室内设计,上传室内照片自动帮你生成多种风格的室内设计图

下载

最后,也是我经常会问自己的一个问题:“我最近对网站做了什么?” 比如,是不是刚安装了新插件?更新了某个主题?升级了WordPress核心?或者,主机提供商是不是更新了PHP版本?这些“最近的改变”往往就是问题的根源。很多时候,问题就出在最后一次操作上,回溯这些操作,往往能帮你快速定位问题。这种思维方式能大大缩小排查范围,避免盲目尝试。

排除插件或主题冲突有哪些高效的方法?

排除插件和主题冲突,这活儿听起来有点枯燥,但却是解决白屏问题最常见的路径。我通常会采用两种策略,具体取决于你是否能进入WordPress后台。

如果你还能勉强进入后台(虽然页面可能不完整): 这是最理想的情况。直接进入“插件”页面,选择所有插件,然后批量“停用”。是的,全部停用,不要犹豫。然后刷新你的网站。如果网站恢复正常,那就说明问题出在某个插件上。接着,你就可以一个一个地重新启用插件,每启用一个就刷新一次网站,直到白屏再次出现。那个导致白屏的插件,就是罪魁祸首。找到它之后,你可以尝试寻找替代品,或者联系插件开发者寻求帮助。主题的排查也类似,先切换到WordPress自带的默认主题(比如Twenty Twenty-Four),如果网站恢复,那就说明是你当前主题的问题。

如果你完全无法进入WordPress后台(这是白屏最常见的情况): 这时候,你就得依赖FTP/SFTP工具了。

  1. 禁用所有插件: 通过FTP/SFTP连接到你的网站服务器,导航到
    wp-content
    目录,你会看到一个
    plugins
    文件夹。将这个文件夹重命名,比如改成
    plugins_old
    。这样做会让WordPress找不到任何插件,从而全部禁用它们。刷新你的网站。如果白屏消失,那问题肯定出在某个插件上。
  2. 逐一排查插件:
    plugins_old
    改回
    plugins
    。然后进入
    plugins
    文件夹,你会看到每个插件都有一个独立的文件夹。你可以把所有插件文件夹都移到一个临时文件夹(比如
    _temp_plugins
    ),然后一个一个地把它们移回
    plugins
    文件夹,每移回一个就刷新网站。当白屏再次出现时,你刚刚移回的那个插件就是问题所在。
  3. 禁用当前主题: 如果禁用所有插件后网站依然白屏,那很可能是主题的问题。回到
    wp-content/themes
    目录,找到你当前激活的主题文件夹,将其重命名(比如
    your-theme-name_old
    )。WordPress会自动回退到默认主题。如果网站恢复正常,那么问题就在你的主题上。

这种通过FTP/SFTP直接操作文件的方式,虽然看起来有点“粗暴”,但却是解决无法访问后台时插件/主题冲突的最高效手段。它绕过了WordPress本身的界面,直接从文件系统层面解决问题。

如何有效提升WordPress的PHP内存限制,避免因资源不足导致的白屏?

提升PHP内存限制是解决因资源不足导致白屏的常见且高效方法,尤其是在你运行了比较多功能复杂、资源消耗大的插件,或者网站内容量非常庞大的时候。我通常会把这个操作看作是给网站“加餐”,确保它有足够的能量去处理各种请求。

最直接、也是我最推荐的方法,是修改你WordPress安装根目录下的

wp-config.php
文件。找到
/* That's all, stop editing! Happy publishing. */
这行注释,在这行之前,添加或者修改以下代码:

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

这里我把内存限制设置为

256M
(兆字节)。对于大多数中小型网站来说,这个值通常是足够的。如果你的网站确实非常庞大,或者调试日志明确指出需要更多内存,你也可以尝试
512M
。但请注意,不要无限制地设置过高,因为这可能会占用服务器上不必要的资源,甚至掩盖其他更深层次的优化问题。选择一个合理的值是关键。

除了

wp-config.php
,还有其他一些地方可以设置PHP内存限制,但它们通常受限于你的主机环境和权限:

  1. php.ini
    文件:
    这是PHP的全局配置文件。如果你有权限访问服务器的
    php.ini
    文件(通常在虚拟主机环境下,你可能只能通过控制面板修改,或者根本没有直接修改权限),你可以找到
    memory_limit
    这一行,并修改其值,例如
    memory_limit = 256M;
    。这个设置会影响你服务器上所有使用该PHP配置的网站。
  2. .htaccess
    文件:
    在某些Apache服务器上,你也可以在网站根目录的
    .htaccess
    文件中添加一行来修改PHP内存限制:
    php_value memory_limit 256M
    。但需要注意的是,这种方法并非所有主机都支持,而且可能会被
    php.ini
    中的设置所覆盖。

在我看来,

wp-config.php
是WordPress特有的、最直接且通常有效的方式。如果修改
wp-config.php
后,白屏问题依然存在且调试日志指向内存问题,那么你可能需要联系你的主机提供商。他们可以帮助你检查服务器的全局PHP配置,确认是否允许你设置的内存限制,或者服务器本身是否还有其他资源瓶颈。毕竟,有时候问题并不完全在于WordPress本身,而是服务器环境的限制。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2521

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1599

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1493

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

952

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1416

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1234

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1445

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1306

2023.11.13

Java 桌面应用开发(JavaFX 实战)
Java 桌面应用开发(JavaFX 实战)

本专题系统讲解 Java 在桌面应用开发领域的实战应用,重点围绕 JavaFX 框架,涵盖界面布局、控件使用、事件处理、FXML、样式美化(CSS)、多线程与UI响应优化,以及桌面应用的打包与发布。通过完整示例项目,帮助学习者掌握 使用 Java 构建现代化、跨平台桌面应用程序的核心能力。

36

2026.01.14

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 8.6万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 7万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号