WordPress 后台白屏通常由插件 PHP 错误引起,最快速的排查方式是通过 FTP 或文件管理器重命名插件目录强制停用所有插件。如果无法登录后台,不要尝试刷新页面,直接操作服务器文件是止损关键。
先说结论:后台白屏多为插件代码致命错误导致,优先通过文件系统强制停用插件恢复访问,再逐个排查。
- 先确认:判断能否登录后台,无法登录则直接使用 FTP 或主机文件管理器操作。
- 先处理:重命名 wp-content/plugins 文件夹为 plugins_old,强制停用所有插件。
- 再验证:恢复文件夹名称后逐个重命名子文件夹,定位具体冲突插件。
命令速用版
如果有 SSH 权限且安装了 WP-CLI,可使用命令快速停用;若无 SSH 权限,请使用文件管理器重命名文件夹。
# 停用所有插件
wp plugin deactivate `--all`
# 查看激活状态
wp plugin list `--status`=active为什么会这样
WordPress 后台白屏通常是 PHP 脚本执行过程中遇到致命错误(Fatal Error),导致页面渲染中断。
插件代码兼容性问题、PHP 版本不匹配或内存不足都可能触发此错误。由于默认配置不显示错误信息,浏览器只能收到空白响应。
分步处理
第一步:开启调试模式
通过 FTP 编辑根目录下的 wp-config.php 文件,找到 define( 'WP_DEBUG', false ); 改为 true,并添加以下代码以便记录日志:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );第二步:强制停用插件
进入 wp-content 目录,将 plugins 文件夹重命名为 plugins_old。刷新后台登录页面,若能正常进入,说明问题确实在插件。
第三步:定位冲突插件
将文件夹名改回 plugins,进入该目录,逐个重命名插件子文件夹(如 add-on 改为 add-old)。每改一个刷新一次后台,直到白屏消失,最后一个被重命名的插件即为冲突源。
怎么验证是否生效
操作完成后,尝试访问 /wp-admin/ 页面。如果页面正常加载,说明插件冲突已解除。检查根目录下的 wp-content/debug.log 文件,查看是否有具体的 PHP 错误堆栈信息,确认错误来源。
常见坑
- 缓存干扰:排查前请清除浏览器缓存和服务器端缓存,避免看到旧页面。
- 主题冲突:如果停用所有插件后仍白屏,可能是当前主题导致,需切换回默认主题测试。
- 内存限制:部分插件需要更高内存,可在 wp-config.php 增加 define( 'WP_MEMORY_LIMIT', '256M' ); 测试。
常见问题
强制停用插件会丢失数据吗?
不会。重命名文件夹仅停用插件功能,数据库中的插件设置和数据通常保留,重新启用后可恢复。
开启 WP_DEBUG 会影响网站安全吗?
调试模式本身不直接暴露信息给访客,但建议修复问题后立即关闭,避免日志文件过大或敏感信息泄露。
找不到 wp-config.php 文件怎么办?
该文件位于 WordPress 安装根目录,与 wp-content 文件夹同级,若找不到请确认是否上传完整。
参考来源
- WordPress.org - White Screen of Death: https://wordpress.org/support/article/white-screen-of-death/
- WordPress.org - Troubleshooting a Plugin Issue: https://wordpress.org/support/article/troubleshooting-a-plugin-issue/
- WordPress.org - Debugging in WordPress: https://wordpress.org/support/article/debugging-in-wordpress/