WooCommerce按属性获取商品失败：自定义搜索无结果问题排查

我有一批带尺寸、颜色等多属性的商品，尝试开发自定义搜索功能，但执行查询后无法获取到任何商品，相关代码如下：

$product_attributes = wc_get_attribute_taxonomies();

$attributes = array();
foreach ($product_attributes as $attribute) {
    $attribute_name =  $attribute->attribute_name;
    $attribute_value = isset($params[$attribute_name]) ? $params[$attribute_name] : '';
    if (!empty($attribute_value)) {
        $attributes['pa_' .$attribute_name] = $attribute_value;
       
    }
}

$ordering              = WC()->query->get_catalog_ordering_args();
$ordering['orderby']   = array_shift(explode(' ', $ordering['orderby']));
$ordering['orderby']   = stristr($ordering['orderby'], 'price') ? 'meta_value_num' : $ordering['orderby'];

dump($attributes);
$args = array(
    'status' => 'publish',
    'limit' => -1,
    'return'            => 'ids',
    'stock_status'      => 'instock',
    'visibility'        => 'visible',
    'paginate'          => true,
    'orderby'           => $ordering['orderby'],
    'order'             => 'DESC',

    'attribute' => $attributes,
);

$products = wc_get_products($args);

代码存在的核心问题 #

• attribute参数用法错误：WooCommerce的wc_get_products函数中，attribute参数仅支持单属性筛选，格式为'attribute' => 'pa_size', 'attribute_term' => 'large'，无法直接接收多属性的关联数组，这是导致无结果的直接原因。
• 多属性筛选未用正确的tax_query：如果需要同时筛选多个商品属性，必须使用tax_query参数来构建多条件的分类查询，而非错误地将所有属性塞进attribute里。

修正后的代码示例 #

$product_attributes = wc_get_attribute_taxonomies();

// 构建多属性查询，默认用AND关系（需同时满足所有属性条件）
$tax_query = array('relation' => 'AND');
foreach ($product_attributes as $attribute) {
    $attribute_name = $attribute->attribute_name;
    $attribute_value = isset($params[$attribute_name]) ? $params[$attribute_name] : '';
    if (!empty($attribute_value)) {
        $tax_query[] = array(
            'taxonomy' => 'pa_' . $attribute_name,
            'field'    => 'slug', // 若$params中是属性值名称，改为'name'；是ID则改为'term_id'
            'terms'    => $attribute_value,
        );
    }
}

$ordering = WC()->query->get_catalog_ordering_args();
$orderby_parts = explode(' ', $ordering['orderby']);
$ordering['orderby'] = array_shift($orderby_parts);
$ordering['orderby'] = stristr($ordering['orderby'], 'price') ? 'meta_value_num' : $ordering['orderby'];

$args = array(
    'status'        => 'publish',
    'limit'         => -1,
    'return'        => 'ids',
    'stock_status'  => 'instock',
    'visibility'    => 'visible',
    'paginate'      => true,
    'orderby'       => $ordering['orderby'],
    'order'         => 'DESC',
    'tax_query'     => $tax_query, // 替换原错误的attribute参数
);

$products = wc_get_products($args);

额外注意事项 #

• 确认$params中传递的属性值类型：如果是属性的别名（slug），保持field为slug；如果是显示名称，改为name；如果是属性值ID，改为term_id。
• 若需要“满足任一属性即可”的筛选逻辑，将tax_query的relation值改为OR。

内容的提问来源于stack exchange，提问作者Ahmad Reza Hajizadeh