fishzzz

WordPress 白屏、500 错误、「网站遇到致命错误」怎么排查

故障排查更新于 约 1800 字

白屏和 500 错误看起来吓人,但绝大多数都是某一个 PHP 文件报了致命错误。只要拿到错误日志里的那一行,问题基本就定位了一半

白屏 / 500 的排查顺序
  1. 确认范围全站还是个别页面,前台还是后台
  2. 打开日志服务器日志或 debug.log
  3. 定位文件看报错文件属于哪个插件或主题
  4. 停用问题插件改名目录让站点先恢复
  5. 查版本和内存PHP 版本、内存上限、扩展
  6. 查是否被篡改核心文件和陌生代码

先确认是谁的问题

  • 全站白屏,后台也打不开:核心文件、全局插件或主题的 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,对照官方原版文件修复

快速恢复的办法

网站急着要打开时,按这个顺序操作,每一步做完刷新看是否恢复

  1. 把 wp-content/plugins 改名为 plugins-off,所有插件都会停用
  2. 如果恢复了,改回原名,再逐个改名单个插件目录找出问题插件
  3. 还没恢复,把当前主题目录改名,WordPress 会切到默认主题(需要有默认主题存在)
  4. 还没恢复,重新上传同版本的 WordPress 核心文件
  5. 都不行,从最近的备份恢复,并保留现场文件以便查原因

排查完要确认是不是被入侵

如果日志里报错的文件你从来没见过、文件名很奇怪(比如随机字母),或者核心文件被改过,网站很可能被入侵了。这种情况光修好报错不够,还要清理后门、找到入侵入口,不然过几天又会出问题

白屏原因查不出来、或者怀疑是被黑了,可以发报错截图和网址给我先看看

把情况发我,先免费看一眼

不用先付钱。我看完直接告诉你问题在哪、能不能做、要多久

先免费判断改动前完整备份工程师本人对接淘宝担保交易

周一至周日 09:00 – 22:00

每天 09:00 – 22:00 在线

微信二维码扫码加微信fishzzz233 淘宝店铺二维码手机淘宝扫码平台担保交易

先免费判断,再决定做不做每天 09:00 – 22:00 · 一般 1 小时内回复

淘宝下单平台担保交易