WordPress自定义主题突发空白页问题排查求助

服务器层面排查 #

• 查看PHP错误日志：WP_DEBUG无法捕获所有致命错误，直接登录服务器或主机面板查看PHP错误日志（路径通常为/var/log/php-fpm/error.log或主机商提供的日志模块），重点找内存耗尽、语法错误、函数调用失败这类记录。
• 验证PHP版本兼容性：部分服务器会自动升级PHP版本，自定义主题可能存在旧语法（如PHP 8.0废弃的create_function、参数类型声明变化），临时回退到之前正常运行的PHP版本测试是否恢复。
• 检查PHP资源限制：确认memory_limit（建议至少64M）、max_execution_time是否被调低，可通过修改php.ini或在.htaccess中添加php_value memory_limit 128M调整后测试。

WordPress核心与主题排查 #

• 切换默认主题：通过FTP将自定义主题文件夹重命名（如my-theme改为my-theme-temp），WordPress会自动切换到Twenty系列默认主题，若页面恢复则问题出在自定义主题。
• 禁用所有插件：将plugins文件夹重命名为plugins-temp，排除插件自动更新或缓存冲突导致的问题，恢复后可逐个启用插件定位具体冲突项。
• 替换核心文件：下载当前站点使用的WordPress版本压缩包，替换wp-admin和wp-includes文件夹（保留wp-content和wp-config.php），排除核心文件损坏。
• 检查主题functions.php：用纯文本编辑器打开主题的functions.php，检查是否存在语法错误、末尾缺失?>或不可见特殊字符，可尝试注释掉部分代码块逐步排查。

数据库相关排查 #

• 启用调试日志：在wp-config.php中添加define('WP_DEBUG_LOG', true);，访问站点后查看wp-content/debug.log，确认是否存在数据库连接失败、表损坏等记录。
• 修复数据库：通过phpMyAdmin对所有数据库表执行REPAIR TABLE操作，或在wp-config.php中添加define('WP_ALLOW_REPAIR', true);，访问wp-admin/maint/repair.php进行自动修复。

缓存与配置排查 #

• 清空所有缓存：包括服务器缓存（Nginx/Apache）、CDN缓存、WordPress插件缓存，缓存文件损坏也可能导致空白页。
• 重置.htaccess：将.htaccess重命名为.htaccess-temp，访问站点让WordPress自动生成新的配置文件，排除Rewrite规则错误或恶意代码注入。

内容的提问来源于stack exchange，提问作者Andrea