WordPress 插件更新后提示“此网站遇到了致命错误”打不开?5 步恢复网站

WordPress 更新插件后网站打不开，提示“此网站遇到了致命错误”（critical error）怎么办？用恢复模式邮件、FTP 重命名插件文件夹或 WP-CLI 快速恢复，再用调试日志找出原因。

WordPress 插件更新后出现致命错误的示意封面图

在 WordPress 后台更新插件后，网站突然只剩一行字：“此网站遇到了致命错误”（英文是 There has been a critical error on this website），前台和后台都打不开。先说结论：这几乎总是刚更新的那个插件（或它与其他插件、PHP 版本不兼容）触发了 PHP 致命错误。处理思路是：先让网站恢复，再找出原因。最快的恢复办法，是通过 FTP 或主机文件管理器把出问题的插件文件夹改名，让 WordPress 停用它。

这个提示是什么意思

从 WordPress 5.2 开始，当 PHP 出现无法继续运行的致命错误时，WordPress 不再显示空白页，而是显示这条通用提示，避免把技术细节暴露给访客。它本身不告诉你原因，真正的原因在邮件、日志里。

第一步：先看管理员邮箱有没有收到邮件

出现致命错误时，WordPress 通常会向站点管理员邮箱发一封邮件，标题类似“你的站点遇到了技术问题”。邮件里有两样有用的东西：

  • 出错的插件或主题名称，以及错误发生的文件和行号；
  • 恢复模式（Recovery Mode）链接：点开后可以登录后台，在恢复模式里停用出问题的插件。

恢复模式链接有有效期，过期后需要重新触发。如果邮件没收到，先看垃圾邮件箱；站点本身发信配置有问题时，也可能收不到，直接看下一步。

第二步：通过文件管理器停用插件（最稳妥）

不依赖邮件，也不依赖后台，适合后台完全打不开的情况：

  1. 用 FTP，或主机面板自带的文件管理器，进入网站根目录的 wp-content/plugins/；
  2. 找到刚更新的插件文件夹，把它重命名，比如在后面加上 -off；
  3. 刷新网站和后台。WordPress 找不到这个插件，就会自动将其停用，网站通常立即恢复；
  4. 如果不确定是哪个插件，可以把整个 plugins 文件夹改名为 plugins-off，网站恢复后再改回来，然后逐个重命名子文件夹，一个一个启用，直到找到问题插件。

只重命名，不要直接删除，这样随时可以改回来。

第三步：如果有 SSH，用 WP-CLI 更快

服务器可以使用 SSH 和 WP-CLI 时，在网站目录下执行（把插件目录名换成你自己的）：

wp plugin list
wp plugin deactivate plugin-folder-name

如果因为致命错误连 WP-CLI 也报错，可以加上 --skip-plugins 参数再试。

第四步：找出真正的原因

网站恢复后，不要急着重新启用插件，先弄清楚为什么出错。常见原因有：

  • PHP 版本不兼容：新版本插件要求更高的 PHP 版本，或者老插件不支持你当前较新的 PHP；
  • 两个插件冲突：比如多个插件定义了同名函数或类；
  • 内存不足：日志中出现“Allowed memory size exhausted”；
  • 更新没有完整完成：下载或解压中断，导致插件文件缺失；
  • 主题调用了插件已移除的函数。

想看到具体报错，可以在 wp-config.php 里临时打开调试日志（注意：不要在访客可见的位置显示错误）：

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

然后复现一次问题，查看 wp-content/debug.log。日志里的 PHP Fatal error 一行会写明出错的文件路径和原因，路径里的插件文件夹名就是肇事者。排查完毕后，记得把调试设置恢复，并删除或保护好日志文件。

第五步：安全地重新更新

  • 先备份：更新前备份文件和数据库，关于备份可参考 SHOPAGG 3.0 控制台详解：站点管理、备份、监控与维护；
  • 看更新说明：在插件的更新日志里确认最低 PHP 和 WordPress 版本要求；
  • 一次只更新一个：别批量更新，这样出问题时马上知道是谁；
  • 先在测试环境验证：重要的网站先在备份站或测试站更新一遍；
  • 必要时先回退：如果新版本确实有问题，可以向插件作者反馈，并暂时使用旧版本。

另外两种容易混淆的情况

实在恢复不了怎么办

  • 如果有更新前的备份，直接恢复备份最快；
  • 把第四步日志中的 Fatal error 那一行、你刚更新的插件名和版本、PHP 版本整理好，发给插件作者或技术支持；
  • 也可以到 SHOPAGG 问答 描述情况。

常见问题

后台和前台都打不开，怎么进去？用恢复模式邮件里的链接，或通过 FTP/文件管理器重命名插件文件夹。

重命名插件文件夹会丢数据吗？不会，插件设置存在数据库里，只是暂时停用。改回名字并重新启用后设置还在，但建议先做好备份。

没有收到恢复模式邮件？先看垃圾邮件，也可能站点邮件发送本来就没配置好，直接用文件管理器处理即可。

说明：本文整理的是 WordPress 官方机制下的通用排查方法，没有引用具体网站案例或截图。不同主机的面板界面有差异，操作前请先备份。

作者：庄朋龙（关于 SHOPAGG）。

分享您的喜爱

猜你感兴趣

发表回复