WordPress搜索查询返回空白页而非404.php页面该如何排查？

第一步：开启调试模式定位错误 #

• 编辑站点根目录的wp-config.php文件，将WP_DEBUG常量的值修改为true，同时新增两行配置开启错误日志记录、禁止前台直接输出错误：

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

• 重新执行一次搜索操作后，查看wp-content/debug.log文件里的报错内容，优先排查PHP语法错误、未定义函数/类这类致命错误，这类错误会直接导致页面渲染中断返回空白。

第二步：校验搜索模板优先级逻辑 #

WordPress模板加载遵循层级规则，搜索结果页会优先加载search.php，只有无结果且search.php未做无结果判断跳转404时，才会触发404逻辑，你需要先检查以下两点：

• 主题根目录是否存在search.php文件，若存在，检查文件内是否有搜索无结果时的逻辑处理：
  正确的无结果跳转404的示例逻辑如下：

  if ( ! have_posts() ) {
      global $wp_query;
      $wp_query->set_404();
      status_header( 404 );
      get_template_part( 404 );
      exit();
  }
  

  若search.php内无上述逻辑，无结果时不会自动加载404模板，若逻辑存在但中间有中断执行的代码，也会导致空白。
• 若主题不存在search.php，检查主题的index.php内的全局文章判断逻辑是否存在缺陷，导致无搜索结果时没有触发404加载流程。

第三步：排查插件冲突 #

• 批量禁用所有第三方插件，重新执行搜索操作，若空白问题消失，再逐个启用插件定位导致冲突的插件，优先排查搜索相关、SEO类、自定义路由类插件。
• 排查是否有自定义代码（主题functions.php、自定义代码片段插件内的代码）通过pre_get_posts钩子修改了搜索查询逻辑，导致查询异常中断。

第四步：临时切换默认主题验证 #

切换到WordPress官方默认主题（如Twenty Twenty-Four），重新执行搜索操作，若问题消失，说明是当前主题的代码缺陷导致，可重点排查当前主题的模板文件、自定义功能代码。

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