WooCommerce可变产品默认变体设置异常：首次加载不生效

问题根源 #

你当前代码使用的woocommerce_before_variations_form钩子执行时机太晚——页面的产品对象已经初始化完成后，这个钩子才触发。此时你更新了_default_attributes的post meta，但当前请求的产品实例不会重新读取这个新值，所以首次加载页面看不到效果；第二次访问时，产品实例会重新从数据库读取更新后的post meta，这时候才会生效。

修复方案 #

方案一：调整钩子时机+同步更新当前产品实例 #

把钩子提前到产品对象初始化后、页面渲染前，同时直接修改当前产品实例的默认属性，确保首次加载就生效，同时更新数据库确保后续访问正常：

add_action( 'woocommerce_before_single_product', 'set_default_variation_job' );
function set_default_variation_job() {
    $product_id = get_the_ID();
    $product    = wc_get_product($product_id);

    // 仅处理可变产品
    if ( !$product->is_type( 'variable' ) ) return;

    // 获取所有变体价格，过滤0价格和无库存的变体
    $active_prices = $product->get_variation_prices()['price'];
    foreach ($active_prices as $variation_id => $price) {
        $variation = wc_get_product($variation_id);
        if ( $price == 0 || !$variation->is_in_stock() ) {
            unset($active_prices[$variation_id]);
        }
    }

    // 没有符合条件的变体直接返回
    if ( empty($active_prices) ) return;

    // 按价格升序排序，取价格最低的变体
    asort($active_prices, SORT_NUMERIC);
    $variation_id = array_keys($active_prices)[0];
    $variation = wc_get_product($variation_id);
    $default_attributes = $variation->get_variation_attributes(false);

    // 更新数据库默认属性，保障后续访问生效
    update_post_meta($product_id, '_default_attributes', $default_attributes);
    
    // 修改当前产品实例的默认属性，让当前页面立即生效
    $product->set_default_attributes($default_attributes);
}

方案二：用过滤器动态返回默认属性（更灵活） #

无需修改数据库，每次页面加载时动态计算符合条件的默认变体，适合库存或价格频繁变动的场景：

add_filter( 'woocommerce_product_get_default_attributes', 'set_dynamic_default_variation_attributes', 10, 2 );
function set_dynamic_default_variation_attributes( $default_attributes, $product ) {
    // 仅处理可变产品
    if ( !$product->is_type( 'variable' ) ) return $default_attributes;

    // 获取所有变体价格，过滤0价格和无库存的变体
    $active_prices = $product->get_variation_prices()['price'];
    foreach ($active_prices as $variation_id => $price) {
        $variation = wc_get_product($variation_id);
        if ( $price == 0 || !$variation->is_in_stock() ) {
            unset($active_prices[$variation_id]);
        }
    }

    // 没有符合条件的变体，返回原默认属性
    if ( empty($active_prices) ) return $default_attributes;

    // 按价格升序排序，取价格最低的变体属性
    asort($active_prices, SORT_NUMERIC);
    $variation_id = array_keys($active_prices)[0];
    $variation = wc_get_product($variation_id);
    
    return $variation->get_variation_attributes(false);
}

方案对比 #

• 方案一：修改数据库默认属性，后续访问直接读取缓存，性能略优；代码每次访问都会检查并更新，库存/价格变动时也能同步更新默认值。
• 方案二：每次加载动态计算，无需修改数据库，完全避免缓存滞后问题，适合库存波动大的场景。

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