- 先恢复访问改名插件目录让网站先打开
- 看错误日志找 Fatal error 的文件和行号
- 样式问题分开查逐项关延迟 JS / 移除未使用 CSS
- 加排除规则只排除出问题的脚本或样式
- 清全部缓存插件、服务器、CDN 三层都清
- 逐页验收首屏、菜单、表单逐个点
先让网站恢复访问
如果激活 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 的文件优化功能。按这个顺序逐项关闭,每关一项清缓存后用无痕窗口看
- 延迟 JavaScript 执行:最常见的原因。脚本被推迟到首次交互,依赖它的轮播、动画在加载时不初始化
- 移除未使用的 CSS:WP Rocket 会扫描页面生成精简样式,扫描时没出现的元素(下拉菜单、弹窗、手机菜单)样式会被裁掉
- 合并 JS / 延迟加载 JS:脚本顺序被打乱,内联脚本找不到 jQuery
- 图片懒加载:首屏图片、轮播图被懒加载后不显示
找到是哪一项后,不要整个关掉,而是把出问题的那个脚本或样式加进排除列表。比如延迟 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
装上就白屏、调了半天样式还是乱的,可以把网址和现象发我看看

