WooCommerce：匹配属性获取商品变体ID返回0问题排查

我希望用简洁优化的代码通过匹配属性获取商品变体ID，编写了zx_get_variation函数，但返回值始终为0，实际存在匹配的变体。重要说明：不想使用$product->get_available_variations()方法，避免嵌套循环。

函数代码：

function zx_get_variation( $product_id, $attributes )
{
    $CPT = new WC_Product_Data_Store_CPT();
    $variation_id = $CPT->find_matching_product_variation( new WC_Product($product_id), $attributes );

    return $variation_id;
}

相关调用代码：

$products_object = [];
$attributes = [
    'attribute_pa_length'       => $filter_length, // term_slug
    'attribute_pa_material'     => $filter_type, // term_slug
    'attribute_pa_eye-type'     => $filter_material // term_slug
];

if( $products_2->have_posts() ):
    while( $products_2->have_posts() ): $products_2->the_post();

       $zx_product_var = zx_get_variation( get_the_ID(), $attributes );
        
        $product_ids[] = get_the_ID();
        $products_object[] = [
            'product_id'                => get_the_ID(),
            'product_title'             => get_the_title( get_the_ID() ),
            'product_price'             => get_post_meta( get_the_ID(), '_price', true ),
            'product_tax'               => get_the_terms( get_the_ID(), 'product_cat' )[0]->name,
            'product_sku'               => get_the_sku( get_the_ID() ),
            'post_date'                 => get_the_date( 'Ymd', get_the_ID() ),
            'product_thumbnail'         => wp_get_attachment_url( get_post_thumbnail_id() ),
            'product_link'              => get_permalink(),
            'attribute_pa_length'       => $filter_length,
            'attribute_pa_eye_type'     => $filter_type,
            'attribute_pa_material'     => $filter_material,
            'variation_id'              => $zx_product_var,
        ];

    endwhile;
endif;

核心问题 #

1. 产品对象类型错误：直接实例化WC_Product无法正确识别可变产品的变体结构，必须使用WC_Product_Variable类型的对象。
2. 属性键名不匹配：调用代码中attribute_pa_eye-type（连字符）和后续数组里的attribute_pa_eye_type（下划线）不一致，WooCommerce存储变体属性时会将连字符转为下划线，导致匹配失败。
3. 数据存储初始化方式不规范：应使用WooCommerce官方推荐的WC_Data_Store::load()方法获取数据存储实例，而非直接实例化WC_Product_Data_Store_CPT。

修正后的函数 #

function zx_get_variation( $product_id, $attributes ) {
    // 获取正确的产品对象，自动处理类型
    $product = wc_get_product( $product_id );
    
    // 校验产品是否存在且为可变类型
    if ( ! $product || ! $product->is_type( 'variable' ) ) {
        return 0;
    }

    // 加载产品数据存储
    $data_store = WC_Data_Store::load( 'product' );
    $variation_id = $data_store->find_matching_product_variation( $product, $attributes );

    return $variation_id ?: 0;
}

调用代码修正 #

统一属性键名，将attribute_pa_eye-type改为attribute_pa_eye_type：

$attributes = [
    'attribute_pa_length'       => $filter_length,
    'attribute_pa_material'     => $filter_type,
    'attribute_pa_eye_type'     => $filter_material // 使用下划线匹配存储的键名
];

额外优化说明 #

• 使用wc_get_product()是WooCommerce的标准做法，能自动处理产品类型、缓存等逻辑，比直接实例化类更可靠。
• 增加产品类型校验，避免对简单产品等非可变产品执行无效操作，提升代码健壮性。

内容的提问来源于stack exchange，提问作者Zohaib Ali Memon