添加meta_query后WordPress自定义搜索返回空白页问题排查

问题根源 #

你当前的查询里，s（标题/内容搜索）和meta_query是同时生效的AND逻辑——只有文章标题包含搜索词，且自定义字段article-key也包含搜索词时才会被返回，这会极大缩小结果范围，甚至直接无匹配导致页面空白。另外如果搜索词为空，meta_query里的LIKE ''会过滤掉所有没有该字段或字段值为空的文章，同样会导致空白。

具体修复方案 #

1. 仅在有搜索词时启用搜索逻辑，同时改为OR匹配 #

修改查询代码，让搜索词同时匹配标题或自定义字段，而非必须同时满足，并且空搜索时不触发搜索过滤：

@php
 $searchTerm = isset($_GET['search']) ? trim($_GET['search']) : '';
 $paged = get_query_var('paged') ? get_query_var('paged') : 1;
 
 // 基础查询参数
 $queryArgs = [
  'post_type' => 'article',
  'posts_per_page' => 12,
  'paged' => $paged,
  'post_status' => 'publish',
  'orderby' => 'menu_order',
  'order' => 'ASC',
  'tax_query' => [
    [
      'taxonomy' => 'type',
      'field' => 'slug',
      'terms' => 'jurisprudence',
    ],
  ],
 ];

 // 只有当搜索词不为空时，才添加搜索相关规则
 if (!empty($searchTerm)) {
  $queryArgs['s'] = $searchTerm;
  // 用relation设置OR逻辑，匹配标题或自定义字段
  $queryArgs['meta_query'] = [
    'relation' => 'OR',
    [
      'key' => 'article-key',
      'value' => $searchTerm,
      'compare' => 'LIKE',
    ],
  ];
 }
@endphp

// 执行查询
@query($queryArgs)

2. 检查自定义字段的正确性 #

• 确认自定义字段的key确实是article-key，可以在后台文章编辑页查看自定义字段列表，或者如果你用了ACF插件，检查字段的“名称”（不是显示标签）。
• 如果该字段存储的是数组、数字这类非字符串内容，LIKE比较会失效，需要根据字段类型调整compare参数，比如数字用=，数组用IN。

3. 调试排查（可选） #

如果还是有问题，可以打印生成的SQL语句看看具体过滤逻辑：

// 在@query之后添加
global $wp_query;
echo '<pre>';
print_r($wp_query->request); // 输出最终执行的SQL
echo '</pre>';

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