WordPress 白屏或只显示半页:先查这 5 个地方

· wordpress · 阅读 11
摘要

WordPress 白屏不给任何提示,因为 PHP 错误被关掉了。按下面五处顺序查。一、打开 WP_DEBUG在 wp-config.php 里加:define('WP_DEBUG', true); define('WP_DEBUG_DIS

WordPress 白屏不给任何提示,因为 PHP 错误被关掉了。按下面五处顺序查。

一、打开 WP_DEBUG

在 wp-config.php 里加:

define('WP_DEBUG', true);
define('WP_DEBUG_DISPLAY', true);
define('WP_DEBUG_LOG', true);

刷新看是否出现 Fatal error 及行号。排查完改回 false。

二、看错误日志

查 wp-content/debug.log 与 php-fpm.log,搜 PHP Fatal error。

三、切回默认主题

把当前主题目录改名,WordPress 自动回落默认主题。能打开就是主题问题,重点查 functions.php。

四、禁用全部插件

把 wp-content/plugins 改名,插件自动停用。恢复后逐个启用,二分定位。

五、按行号查代码

三种高频成因:钩子挂了不存在的函数、模板调用 null 对象、PHP 版本不兼容新语法。

常见问题

Q1:只显示半页(截断)怎么查?

多半是 PHP 内存超限或执行超时。调高 memory_limit 与 max_execution_time,再复现看日志的 Allowed memory size exhausted。

Q2:后台能进前台白屏?

主题问题概率最大,先切默认主题验证。

Q3:改了代码反而白屏?

查是否漏了分号、括号,或多出 BOM 头。用编辑器把文件编码存为 UTF-8 无 BOM。

Q4:上传图片后白屏?

GD 或 Imagick 扩展缺失,或上传目录权限不足。查 wp-content/uploads 权限。