WordPress Meta Query多参数下为不同meta键配置关联关系方法

WordPress 原生 WP_Query 的 meta_query 支持多层嵌套结构，可给不同层级的查询组单独指定关联关系，完全可以满足需求，核心逻辑分层如下：

• 最外层查询组固定使用 AND 关联，保证所有生效的筛选条件必须同时满足
• 必选条件 active_inactive = Active 直接放在最外层，全局生效
• 每个可选筛选维度（asset_category/asset_type/difficulty_level）单独封装为独立子查询组，组内使用 OR 关联，实现同维度多值匹配只要命中其一即可的效果
• 仅当对应筛选参数存在时，才将对应维度的子查询组加入查询，实现可选筛选效果

$args = array(      
    'post_type'      => 'asset',
    's'              => $keyword,
    'posts_per_page' => -1,
    'orderby'        => 'title',
    'order'          => 'ASC',
    'post_status'    => 'publish',
    'meta_query'     => array(
        'relation' => 'AND',
        // 全局必选条件：状态必须为Active
        array(
            'key'     => 'active_inactive',
            'value'   => 'Active',
            'compare' => '=',
        ),
    )
); 

// 处理asset_category筛选
if (isset($_GET['category']) && !empty($_GET['category'])) {
    $category_query = array('relation' => 'OR');
    $cat_values = is_array($_GET['category']) ? $_GET['category'] : array($_GET['category']);
    foreach ($cat_values as $cat) {
        $category_query[] = array(
            'key'     => 'asset_category',
            'value'   => sanitize_text_field($cat),
            'compare' => 'LIKE',
        );
    }
    $args['meta_query'][] = $category_query;
}

// 处理asset_type筛选
if (isset($_GET['assetType']) && !empty($_GET['assetType'])) {
    $type_query = array('relation' => 'OR');
    $type_values = is_array($_GET['assetType']) ? $_GET['assetType'] : array($_GET['assetType']);
    foreach ($type_values as $type) {
        $type_query[] = array(
            'key'     => 'asset_type',
            'value'   => sanitize_text_field($type),
            'compare' => 'LIKE',
        );
    }
    $args['meta_query'][] = $type_query;
}

// 处理difficulty_level筛选
if (isset($_GET['levels']) && !empty($_GET['levels'])) {
    $level_values = is_array($_GET['levels']) ? $_GET['levels'] : array($_GET['levels']);
    $args['meta_query'][] = array(
        'key'     => 'difficulty_level',
        'value'   => $level_values,
        'compare' => 'IN',
    );
}

$wp_query_arr[] = new WP_Query($args);

• 原有代码的问题在于将同个meta键的多个筛选条件平级加入全局AND组，会要求同个字段必须同时匹配所有传入值，不符合业务逻辑
• 同维度多值匹配：每个筛选维度单独作为OR子组，比如同时传入分类A、分类B，只要文章asset_category匹配其中一个就满足该维度条件
• 跨维度匹配：所有加入查询的条件组（包括必选状态、各个生效的筛选维度）之间都是AND关系，必须同时满足才会返回结果
• 代码额外加了empty()判断和sanitize_text_field()输入清洗，避免传入空参数导致查询异常，同时修复了原代码中单值传入assetType时错误读取$_GET['asset_type']键的bug
• 难度字段因为用IN比较符，本身就支持数组值匹配，不需要额外套OR组，直接传值数组即可

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