XinTheme Cache 使用文档

常见问题与排查

缓存没有生效时先检查这些项

  • wp-config.php 是否启用了 WP_CACHE
  • wp-content/advanced-cache.php 是否存在。
  • 当前访问是否为未登录状态。
  • 页面是否返回 HTTP 200 状态码。
  • 是否被文章 ID、路径、查询字符串或 Cookie 排除。
  • Nginx/Apache 直出规则是否与固定链接尾部斜杠一致。
  • 压缩缓存是否真实生成了 .gz 或 .br 文件。
  • 预压缩直出时是否出现重复的 Content-Encoding 响应头。

如何查看当前是否命中缓存

响应头含义
X-Cache-Handler: xintheme-cache命中插件 PHP drop-in 缓存。
X-Cache-Handler: xintheme-cache-nginx命中 Nginx 直出缓存。
X-Cache-Handler: xintheme-cache-apache命中 Apache 直出缓存。

XinTheme Cache 会缓存后台页面吗?

不会。插件会排除 WordPress 后台、预览页、Feed、robots、密码保护页面等不适合缓存的请求。

登录用户会命中缓存吗?

默认不会,默认 Cookie 排除规则会跳过已登录用户相关请求,避免把个性化内容缓存给其他用户。

企业官网推荐开启哪些设置?

通常建议开启 HTML 压缩、Gzip 预压缩缓存;如果移动端和桌面端 HTML 不同,再开启移动端独立缓存。服务器层直出缓存建议先用普通 HTML 测通,再开启压缩缓存。

WooCommerce 网站可以用吗?

可以,但购物车、结账页、我的账户页等动态页面必须排除缓存。商品页和分类页通常可以缓存。

可以和 Autoptimize 一起用吗?

可以。建议 XinTheme Cache 负责整页静态缓存,Autoptimize 负责 CSS 和 JavaScript 优化。为了避免重复处理,建议关闭 Autoptimize 的 HTML 优化。

可以和其他页面缓存插件一起用吗?

不建议。多个整页缓存插件可能争用 wp-content/advanced-cache.php,导致缓存逻辑互相覆盖。一个网站只保留一个整页缓存插件更稳定。

常见可能冲突的插件包括 WP Super Cache、W3 Total Cache、WP Fastest Cache 等等,以及部分主机商缓存插件。

为什么清理缓存后第一次访问仍然慢一点?

清理缓存后,第一次访问需要 WordPress 重新生成页面并写入缓存文件。从第二次访问开始才会命中缓存。

这页内容对你有帮助吗?