WordPress 白屏排查手册:关插件、换主题、开调试、查 PHP(附停手信号)

署名:DEVDIY

标签:WordPress, 白屏, 故障排查, PHP, 插件冲突

原文/延伸阅读:https://devdiy.cn/wordpress/

网站一打开只剩白页,后台也进不去------先别重装 WordPress。

多数白屏来自插件冲突、主题致命错误、PHP 版本不匹配或内存不足。按「关插件 → 换默认主题 → 开调试写日志 → 查 PHP/内存」走一遍,大约一刻钟往往就能定位到责任层。前提是你能通过 FTP、SFTP 或主机面板打开站点根目录(能看到 wp-content)。

先给现象分级

现象 更可能的责任层
前台白、后台还能进 当前主题或前台插件;核心与数据库多半还在
前台后台都白 插件冲突、内存耗尽、PHP 不兼容、配置异常
偶发白/个别页面白 模板、缓存或特定钩子,勿与「全站挂掉」混处理

分级的意义:先确认你还能不能改文件、改不改得了插件目录,再决定下一步。盲目覆盖安装包,容易把本可恢复的配置盖掉。

四步自查

1. 批量停用插件(约 3 分钟)

路径:wp-content/plugins/

把整个 plugins 文件夹临时改名为 plugins-disabled,刷新前台和后台。

  • 白屏消失 → 问题在某个插件。改回后逐个恢复目录名,定位冲突插件后停用或替换。
  • 仍白 → 进入下一步。

注意:会员、多语言等「强依赖」插件关停后功能会缺,但先恢复可访问性,再谈功能。

2. 切到默认主题(约 2 分钟)

路径:wp-content/themes/

确认目录里还有官方默认主题;把当前主题文件夹改名(如加 -bak)。WordPress 找不到当前主题时,往往会回退到可用的默认主题。

  • 恢复显示 → 问题在主题(含子主题自定义代码、过期构建器模板等)。
  • 仍白 → 更可能在核心、PHP 环境或 wp-config.php。

3. 打开调试,让白屏「说话」(约 3 分钟)

在 wp-config.php 中(/* That's all, stop editing! */ 之前)临时加入或改为:

php 复制代码
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
@ini_set('display_errors', 0);

再触发一次白屏,查看 wp-content/debug.log。对着路径和插件名改,比盲猜快。排完记得收紧调试配置,避免生产环境长期暴露细节。

4. 查 PHP 版本与内存(约 5~7 分钟)

在主机面板核对:

  • PHP 版本是否与主题/插件要求一致;
  • memory_limit 是否过低(可酌情提高,勿超过主机实际允许值);
  • Nginx/Apache、PHP-FPM 的 error log------有时白屏发生在 WordPress 还没起来之前。

这些情况请停手做安全排查

出现以下信号时,优先隔离与备份现场,而不是「覆盖主题凑合上线」:

  • 冒出陌生 PHP 文件;
  • wp-config.php 被插入异常代码;
  • 管理员账号凭空变多;
  • 固定跳转到陌生域名;
  • 核心目录与正常更新对不上;
  • 浏览器或搜索引擎提示站点被篡改。

交付边界一句话

优先动子主题和自定义插件,不建议直接改 WordPress 核心。白屏修复目标是:恢复可访问、找到责任组件、留下日志------不是顺手大重构。

我们是 DEVDIY(北京互联商通)。三条业务平级:WordPress 外贸站、Shopify 外贸站、微信小程序定制,按需求单独做,不捆绑。白屏属于 WordPress 侧排障。

走完四步仍恢复不了,或已怀疑安全问题:可说明环境、最近是否更新过插件/PHP、能否提供 debug.log 片段,通过官网联系做诊断边界确认。

延伸阅读:https://devdiy.cn/wordpress/

案例参考:https://devdiy.cn/cases/

相关推荐
来让爷抱一个9 小时前
Python 异步里混用同步库,事件循环被卡住的全过程
开发语言·python
心祭丫丫12 小时前
【每天一个 Python 小案例17】Python 实现通讯录
开发语言·人工智能·笔记·python·学习
露天赏雪13 小时前
第3篇:Sentinel熔断降级实战:大模型接口抖动时的服务兜底方案
java·开发语言·人工智能·spring boot·spring·servlet·sentinel
yeccheng15 小时前
MySQL 索引超详解:从底层 B+ 树到面试高频考点
java·开发语言·jvm·mysql·面试
联犀15 小时前
纯 Go 的 CAD 开源库 go-cad:直接解析 DWG/DXF,现在也能导出 PDF
开发语言·golang·pdf
zjxtxdy16 小时前
C++面向对象程序开发-类与对象
开发语言·c++
测试界的小码农18 小时前
【Linux 命令实战(03):文件创建、复制、移动与删除,掌握 touch、mkdir、cp、mv、rm】
linux·服务器·php
qq_4069810318 小时前
c++拷贝构造函数
开发语言·c++
爱喝雪碧的可乐18 小时前
MATLAB
开发语言·算法·matlab
H.莓飛20 小时前
【C++】【STL】vector_OJ题
linux·服务器·开发语言·数据结构·c++·visual studio