fishzzz

WP Rocket 装上就白屏或者样式乱了:常见原因和解决办法

速度与跑分更新于 约 1800 字

WP Rocket 出问题一般分两类:一类是 PHP 致命错误,整站白屏,连后台都进不去;另一类是网站能打开,但样式乱了、按钮点不动。两类处理方式完全不同

WP Rocket 出问题的排查顺序
  1. 先恢复访问改名插件目录让网站先打开
  2. 看错误日志找 Fatal error 的文件和行号
  3. 样式问题分开查逐项关延迟 JS / 移除未使用 CSS
  4. 加排除规则只排除出问题的脚本或样式
  5. 清全部缓存插件、服务器、CDN 三层都清
  6. 逐页验收首屏、菜单、表单逐个点

先让网站恢复访问

如果激活 WP Rocket 后整站白屏或者报「此网站遇到了致命错误」,连后台都进不去,先用 FTP、SFTP 或主机文件管理器,把 wp-content/plugins/wp-rocket 目录改个名字,比如加上 -off。WordPress 找不到插件会自动停用它,网站就能打开了

另外检查这几个地方有没有 WP Rocket 留下的东西

  • wp-config.php 里的 define('WP_CACHE', true);
  • wp-content/advanced-cache.php
  • 网站根目录 .htaccess 里 # BEGIN WP Rocket 到 # END WP Rocket 之间的规则

插件停用但 advanced-cache.php 还在、WP_CACHE 还是 true 时,有些环境会继续报错,把这个文件也改名

白屏:找到致命错误的那一行

白屏几乎都是 PHP 致命错误。打开错误日志找原因,常见位置

  • 主机面板的错误日志(宝塔在网站设置里,cPanel 在 Errors)
  • 在 wp-config.php 里打开调试日志,错误会写进 wp-content/debug.log
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

日志里找 PHP Fatal error,会写明是哪个文件第几行。我遇到过的几种

  • PHP 版本不兼容:旧版 WP Rocket 在 PHP 8 上调用了已经改变行为的函数,升级插件就好
  • 和新版 WordPress 冲突:WordPress 大版本更新后,钩子回调的写法变了,旧版插件里某个字符串函数拿到了不是字符串的参数直接报错。临时办法是加一个小的修正插件放在 mu-plugins 里,长期办法是升级 WP Rocket
  • 内存不够:报 Allowed memory size exhausted,在 wp-config.php 里调高 WP_MEMORY_LIMIT
  • 破解版或者来源不明的安装包:文件被改过或者不完整,这种直接换正版

样式乱、按钮不动:按功能逐项关

网站能打开但样式错乱、轮播不动、菜单点不开,问题出在 WP Rocket 的文件优化功能。按这个顺序逐项关闭,每关一项清缓存后用无痕窗口看

  1. 延迟 JavaScript 执行:最常见的原因。脚本被推迟到首次交互,依赖它的轮播、动画在加载时不初始化
  2. 移除未使用的 CSS:WP Rocket 会扫描页面生成精简样式,扫描时没出现的元素(下拉菜单、弹窗、手机菜单)样式会被裁掉
  3. 合并 JS / 延迟加载 JS:脚本顺序被打乱,内联脚本找不到 jQuery
  4. 图片懒加载:首屏图片、轮播图被懒加载后不显示

找到是哪一项后,不要整个关掉,而是把出问题的那个脚本或样式加进排除列表。比如延迟 JS 里排除 jquery、主题的主脚本,以及轮播插件的脚本

改完一定要清三层缓存

WP Rocket 改设置后要清理

  • WP Rocket 自身的缓存(工具栏「清除缓存」)
  • 服务器层面的缓存,比如 Nginx fastcgi_cache、主机自带的缓存(SiteGround、Cloudways 都有)
  • CDN 缓存,比如 Cloudflare、阿里云 CDN

只清了插件缓存、没清 CDN,访客看到的还是之前那份乱掉的页面

手机端缓存要单独确认

WP Rocket 有一个「为移动设备单独缓存」选项,如果主题手机和电脑输出不同的 HTML,这个要打开。用 WP-CLI 激活插件时,这个选项和对应的缓存目录有时没生成,结果手机访客一直拿不到缓存。可以在服务器上看 wp-content/cache/wp-rocket/域名/ 下面有没有带 -mobile 的文件

什么时候不建议用 WP Rocket

  • 主机是 LiteSpeed 服务器,用 LiteSpeed Cache 效果更好
  • 托管在 WordPress.com 这类平台上,平台自己的缓存会顶掉 WP Rocket
  • 服务器是 Apache 而网站装了 LiteSpeed Cache,那个插件在 Apache 上不起作用,这时反而应该换 WP Rocket

装上就白屏、调了半天样式还是乱的,可以把网址和现象发我看看

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

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

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

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

每天 09:00 – 22:00 在线

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

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

淘宝下单平台担保交易