合并WP_Query查询时输入无效关键词返回全部文章问题排查

当输入无效关键词时，$matching_categories返回空数组，导致$category_ids也为空。此时$args2中的tax_query因terms参数为空，会被WordPress自动忽略，第二个查询$query_args2直接返回所有文章。两个查询合并后自然包含全部内容，最终的$query不会进入else分支返回“not found”。

另外还有一个隐性问题：如果两个查询都无结果，$merged_posts是空数组，wp_list_pluck得到的post__in也为空，WP_Query会忽略post__in参数，同样返回所有文章。

方案1：基于现有代码快速修复 #

仅在有匹配分类时执行第二个查询，同时提前检查合并结果是否为空：

$args1 = array(
  "post_type" => 'post',
  "posts_per_page" => -1,
  "orderby" => 'date',
  "s" => $search_field_value,
);

// 搜索匹配关键词的分类
$matching_categories = get_terms('category', array('name__like' => $search_field_value));
$category_ids = wp_list_pluck($matching_categories, 'term_id');

// 初始化两个查询，第二个查询默认空结果
$query_args1 = new WP_Query($args1);
$query_args2 = new WP_Query();

// 仅当有匹配分类时，执行分类关联文章查询
if (!empty($category_ids)) {
    $args2 = array(
        "post_type" => 'post',
        "posts_per_page" => -1,
        "orderby" => 'date',
        "tax_query" => array(
            array(
                "taxonomy" => 'category',
                "field" => 'term_id',
                "terms" => $category_ids,
                "operator" => 'IN',
            ),
        ),
    );
    $query_args2 = new WP_Query($args2);
}

// 合并并去重结果
$merged_posts = array_merge($query_args1->posts, $query_args2->posts);
$merged_posts = array_unique($merged_posts, SORT_REGULAR);

// 提前检查合并结果是否为空
if (empty($merged_posts)) {
    echo 'not found';
} else {
    $args = array(
        "post_type" => 'post',
        "posts_per_page" => -1,
        "orderby" => 'date',
        "post__in" => wp_list_pluck($merged_posts, 'ID'),
    );

    $query = new WP_Query($args);
    if ($query->have_posts()) { 
        // 循环输出文章内容
    } else {
        echo 'not found';
    }
}

方案2：单查询实现（更高效） #

避免多次查询合并，直接通过SQL钩子实现“标题/内容含关键词 OR 分类名称含关键词”的逻辑，减少数据库请求：

$search_value = $search_field_value;

// 添加SQL查询钩子，修改WHERE条件实现OR逻辑
add_filter('posts_where', 'custom_search_where_clause');
function custom_search_where_clause($where) {
    global $wpdb, $search_value;
    
    if (!empty($search_value)) {
        // 拼接分类名称匹配的SQL片段
        $category_match = $wpdb->prepare(
            "OR EXISTS (
                SELECT 1 FROM $wpdb->term_relationships tr
                JOIN $wpdb->term_taxonomy tt ON tr.term_taxonomy_id = tt.term_taxonomy_id
                JOIN $wpdb->terms t ON tt.term_id = t.term_id
                WHERE tr.object_id = $wpdb->posts.ID
                AND tt.taxonomy = 'category'
                AND t.name LIKE %s
            )",
            '%' . $wpdb->esc_like($search_value) . '%'
        );
        // 把原搜索条件和分类条件用OR合并
        $where = preg_replace('/AND \((.*?)\)/', 'AND (($1) ' . $category_match . ')', $where);
    }
    return $where;
}

// 执行主查询
$query = new WP_Query(array(
    "post_type" => 'post',
    "posts_per_page" => -1,
    "orderby" => 'date',
    "s" => $search_value,
));

// 移除钩子，避免影响后续查询
remove_filter('posts_where', 'custom_search_where_clause');

if ($query->have_posts()) { 
    // 循环输出文章内容
} else {
    echo 'not found';
}

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