- 确认范围全站还是个别页面,前台还是后台
- 打开日志服务器日志或 debug.log
- 定位文件看报错文件属于哪个插件或主题
- 停用问题插件改名目录让站点先恢复
- 查版本和内存PHP 版本、内存上限、扩展
- 查是否被篡改核心文件和陌生代码
先确认是谁的问题
- 全站白屏,后台也打不开:核心文件、全局插件或主题的 functions.php 报错,也可能是 PHP 本身起不来
- 只有前台白屏,后台正常:主题或者只在前台加载的插件
- 只有某个页面 500:这个页面用到的短代码、页面构建器组件或者模板
- 刚做了操作后出现:刚装的插件、刚升级的 WordPress 或 PHP,先回想最近改了什么
如果看到的不是白屏而是 502、503、504,那是另一类问题:PHP 进程或者上游服务没响应,参考宝塔 502 那篇
打开错误日志
WordPress 5.2 以后报错时会显示「此网站遇到了致命错误」,并给管理员邮箱发一封带错误详情的邮件。收不到邮件的话,自己打开日志
方法一:在 wp-config.php 里 /* That's all, stop editing! */ 这一行上面加
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
再刷新一次出错的页面,错误会写进 wp-content/debug.log。查完记得改回 false
方法二:看服务器的 PHP 错误日志。宝塔在「网站 → 设置 → 日志」,cPanel 在「Errors」,自己的服务器一般在 /var/log/php-fpm/ 或者 Nginx 的 error.log 里
日志里找 PHP Fatal error 或 PHP Parse error,后面会写文件路径和行号
根据报错的文件判断
- 路径在
wp-content/plugins/某插件/:这个插件出了问题,把它的目录改名停用 - 路径在
wp-content/themes/某主题/:主题的问题,到数据库里把主题临时切回默认主题,或者把主题目录改名 - 路径在
wp-includes/或wp-admin/:核心文件损坏或被改动,重新上传同版本的 WordPress 核心文件(不覆盖 wp-content 和 wp-config.php) - 路径在
wp-content/mu-plugins/:这里的插件会自动加载、后台看不到,经常是主机商、迁移工具或者木马放进去的
常见的几种错误
内存不够
报错是 Allowed memory size of 134217728 bytes exhausted。在 wp-config.php 加 define('WP_MEMORY_LIMIT', '256M');,同时检查 PHP 的 memory_limit。如果调高后还是很快用完,说明有插件在死循环,比如小部件自己引用自己导致无限递归
PHP 版本不兼容
升级 PHP 7 到 8 以后最常见。老插件用了已经删除的函数(比如 create_function、each),或者把字符串当数组用。处理办法是升级插件,没有新版的就换插件,实在不行先把 PHP 版本切回去
升级 WordPress 后白屏
WordPress 大版本更新偶尔会让老插件失效。如果后台进不去,先改名插件目录让站点恢复,再逐个启用找出不兼容的那个。我遇到过升级后缓存插件和独立安装的 Meta Box 插件导致致命错误,主题已经自带了同样的类库,两份代码重复定义就报错
清理木马后白屏
很多人删掉被植入的代码后网站反而白屏了,常见原因是只删了一半:木马代码嵌在正常文件中间,删的时候少删了一个括号或者留下了空的变量赋值,导致语法错误。打开日志看是哪一行的 Parse error,对照官方原版文件修复
快速恢复的办法
网站急着要打开时,按这个顺序操作,每一步做完刷新看是否恢复
- 把
wp-content/plugins改名为plugins-off,所有插件都会停用 - 如果恢复了,改回原名,再逐个改名单个插件目录找出问题插件
- 还没恢复,把当前主题目录改名,WordPress 会切到默认主题(需要有默认主题存在)
- 还没恢复,重新上传同版本的 WordPress 核心文件
- 都不行,从最近的备份恢复,并保留现场文件以便查原因
排查完要确认是不是被入侵
如果日志里报错的文件你从来没见过、文件名很奇怪(比如随机字母),或者核心文件被改过,网站很可能被入侵了。这种情况光修好报错不够,还要清理后门、找到入侵入口,不然过几天又会出问题
白屏原因查不出来、或者怀疑是被黑了,可以发报错截图和网址给我先看看

