WordPress站点WooCommerce全部分类页面仅显页眉页脚空白求助

• 开启WordPress调试模式定位错误
  找到站点根目录下的wp-config.php文件，修改对应配置项：

  // 原有false改为true
  define( 'WP_DEBUG', true );
  // 新增以下两项配置，错误日志会输出到wp-content/debug.log文件
  define( 'WP_DEBUG_LOG', true );
  define( 'WP_DEBUG_DISPLAY', false );
  

  配置保存后访问一次空白分类页，打开debug.log文件查看是否有PHP致命错误提示，可直接定位到报错的插件、主题文件位置，这是最高效的定位方式。
• 排查主题模板冲突
  临时将站点主题切换为WordPress默认主题（如Twenty Twenty-Four）或WooCommerce官方默认主题Storefront，若分类页恢复正常，说明问题出在当前使用的主题上：
  到当前主题文件夹的woocommerce子目录下，查找是否存在archive-product.php、taxonomy-product_cat.php两个分类模板文件，临时将两个文件重命名，让WooCommerce调用官方默认模板测试，若恢复正常则说明主题自带的分类模板存在语法错误或版本不兼容，对照最新版WooCommerce的默认模板修正即可。
• 重置固定链接规则
  进入站点后台【设置】-【固定链接】页面，无需修改任何配置，直接点击「保存更改」按钮刷新站点重写规则，排除重写规则异常导致的分类页加载失败问题。
• 全量插件冲突排查
  一次性禁用所有插件仅保留WooCommerce，测试分类页是否恢复，若恢复则逐个启用插件，找到触发冲突的插件即可。同时清理所有缓存（服务器缓存、CDN缓存、站点缓存插件缓存）后再测试，避免缓存干扰判断。
• 排查自定义代码异常
  若你曾在主题functions.php文件中添加过自定义代码，尤其是通过pre_get_posts等钩子修改产品查询逻辑的代码，可逐段注释测试，定位是否是自定义代码逻辑错误导致分类查询返回异常。

内容的提问来源于stack exchange，提问作者neilticktin