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/

相关推荐
ShineWinsu2 小时前
对于JavaScript:JavaScript基础语法的解析
开发语言·前端·javascript·面试·web·基础语法·循环
普通人63 小时前
php+html+canvas实现树状打开的结构
开发语言·javascript·html5·1024程序员节
电商API_180079052473 小时前
反向海淘多币种结算:汇率该在哪个时点被冻结
java·开发语言·数据库·跨境电商·1688 api
开开心心就好4 小时前
多份文档怎么批量打印?支持多种格式
java·服务器·开发语言·pdf·ocr·散列表·启发式算法
Want5954 小时前
Python炫酷烟花①
开发语言·python
天远API5 小时前
零信任架构实战:基于天远公安二要素政务版构建自动化不动产交易与契税核算实名核实网关
人工智能·架构·自动化·php
星夜离尘565 小时前
MATLAB 线性去趋势为何损伤低频正弦:联合最小二乘估计幅相与漂移
开发语言·matlab
程序员清风5 小时前
双指针与滑动窗口:高效处理连续区间
开发语言·算法
开开心心就好6 小时前
文件被占用删不掉?解锁工具强制删除
java·运维·服务器·开发语言·前端·pdf·ocr