署名: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 片段,通过官网联系做诊断边界确认。