WordPress白屏(White Screen of Death,WSoD)通常由插件/主题冲突、PHP内存耗尽、核心文件损坏、服务器配置错误等引起。以下是系统化的排查与解决方案，按"由易到难"顺序执行，可快速定位并修复90%以上的白屏故障。
一、3步快速急救(5分钟完成)
| 步骤 | 操作 | 现象判定 | 解决动作 |
|---|---|---|---|
| 1 | 强制刷新 Ctrl+F5 或手机流量访问 | 刷新后正常 | 本地缓存问题，无需后续操作 |
| 2 | 一键禁用插件 FTP重命名 /wp-content/plugins → plugins_old |
网站恢复 | 逐个把插件文件夹移回，找出冲突插件后删除或替换 |
| 3 | 切换默认主题 FTP重命名当前主题文件夹 → 主题名_bak |
网站恢复 | 主题不兼容，联系主题作者更新或换主题 |
二、启用调试模式看错误(定位根因)
在wp-config.php里找到
define('WP_DEBUG', false);替换为
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);刷新白屏页面后，打开/wp-content/debug.log，搜索Fatal error、Allowed memory size... 等关键词，可直接看到出错的插件/主题/行号。
三、六大深层原因与针对性修复
| 原因 | 典型日志/现象 | 解决方案 |
|---|---|---|
| 1. PHP内存耗尽 | Allowed memory size exhausted |
在 wp-config.php 追加 define('WP_MEMORY_LIMIT', '256M'); 仍报错则联系主机在 php.ini 把 memory_limit 调到 256 M 以上 |
| 2. 插件冲突 | 禁用插件后正常 | 逐个启用，找出肇事者后删除/换同类插件；以后先在测试环境更新插件 |
| 3. 主题兼容 | 切换默认主题后正常 | 回退到官方 Twenty 系列，或等待主题更新；勿直接修改主题核心文件 |
| 4. .htaccess 损坏 | 仅前端或后台白屏 | FTP 重命名 .htaccess → .htaccess_bak，然后后台"设置-固定链接"点保存重新生成 |
| 5. PHP版本过低 | 更新后白屏 | 主机面板切到 PHP 7.4 或 8.0；低于 7.4 已不被 WordPress 6.x 支持 |
| 6. 核心文件损坏 | 前后台皆白屏且无日志 | 下载官方 WordPress 安装包，解压后覆盖除 wp-content 与 wp-config.php 外的所有文件 |
四、特殊场景速查表
| 场景 | 快速处理 |
|---|---|
| 维护模式卡死 | 删除网站根目录的 .maintenance 文件 |
| 数据库表崩溃 | 在 wp-config.php 加 define('WP_ALLOW_REPAIR', true); 然后访问 https://wodepress.com/wp-admin/maint/repair.php 执行"修复并优化" |
| 迁移后白屏 | 检查 wp-config.php 里的数据库名、用户名、主机名是否与新环境一致；确认 wp-content 权限为 755 |
| CDN/缓存残留 | 清空 CDN（Cloudflare、阿里云等）缓存，关闭缓存插件（WP Rocket、W3TC）再试 |
五、终极建议
任何大动作前先用UpdraftPlus或主机快照做"文件+数据库"备份。
主机支持一键Staging的，先在staging环境复现并修复，再推送到正式站。
若以上方法均无效，把debug.log最新20行发给你的主机商或开发者，通常30分钟内可给出服务器级修复方案。
按照"急救→调试→深层原因→特殊场景"顺序执行，90%的白屏可在10分钟内恢复;剩余10%多为服务器或数据库损坏，需主机商或专业运维公司介入。
原文