程序化创建的WooCommerce产品变体无法选中，如何通过PHP强制更新产品？

这个问题我之前也碰到过，本质是自定义脚本没有触发WooCommerce后台点击「Update」按钮时的完整同步流程——后台更新会自动处理属性关联、缓存刷新、变体状态同步等一系列隐藏操作，而你的脚本目前只覆盖了部分步骤。

先看你的场景：自定义PHP创建产品变体后，前端显示禁用无法选中，但后台手动更新后恢复正常。下面是具体的解决方案，结合你的代码进行修改：

问题根源 #

WooCommerce在后台更新产品时，除了保存基础数据，还会触发：

• 产品属性与变体的关联同步
• 产品缓存（临时数据）的清理
• 内置动作钩子，更新变体的可用性状态
• 全局产品缓存的刷新

你的现有代码调用了sync()和wc_delete_product_transients()，但缺少了绑定变体属性、触发核心动作钩子的关键步骤。

修复后的完整代码 #

修改你的save_wc_custom_attributes函数，补充以下关键操作：

function save_wc_custom_attributes($post_id, $custom_attributes) {
    $i = 0;
    $product = wc_get_product( $post_id );
    $product_id = $post_id;

    $terms = wp_get_post_terms( $post_id, 'pa_farge') ;
    // Remove existing colors from the product
    foreach ( $terms as $term ) {
        wp_remove_object_terms( $post_id, $term->term_id, 'pa_farge' );
    }

    $terms = wp_get_post_terms( $post_id, 'pa_str') ;
    // Remove existing sizes from the product
    foreach ( $terms as $term ) {
        wp_remove_object_terms( $post_id, $term->term_id, 'pa_str' );
    }

    foreach ($custom_attributes as $name => $value) {
        // Relate post to a custom attribute, add term if it does not exist
        wp_set_object_terms($post_id, $value, $name, true);

        // Create product attributes array
        $product_attributes[$i] = array(
            'name' => $name, // set attribute name
            'value' => $value, // set attribute value
            'is_visible' => 1,
            'is_variation' => 1,
            'is_taxonomy' => 1
        );
        $i++;
    }

    // Now update the post with its new attributes
    update_post_meta($post_id, '_product_attributes', $product_attributes);

    // Details for the variation
    $variation_post = array(
        'post_title' => $product->get_name(),
        'post_name' => 'product-'.$product_id.'-variation',
        'post_status' => 'publish',
        'post_parent' => $product_id,
        'post_type' => 'product_variation',
        'guid' => $product->get_permalink()
    );

    if( !$product->has_child() ) {
        // Creating a single variation if none exists
        $variation_id = wp_insert_post( $variation_post );
        $variation = new WC_Product_Variation( $variation_id );
        $variation->set_regular_price( $product->get_price() );
        
        // 关键：绑定变体对应的属性值（替换为你实际的术语slug）
        $variation->set_attributes(array(
            'pa_farge' => 'any', // "任意颜色"的术语slug
            'pa_str' => 'any'    // "任意尺寸"的术语slug
        ));
        
        $variation->save(); // Save the data

        $product_variable = new WC_Product_Variable($post_id);
        $product_variable->sync($post_id);
        
        // 刷新所有相关缓存
        wc_delete_product_transients($post_id);
        wp_cache_delete($product_id, 'products');
        wp_cache_delete($product_id, 'product_meta');
        
        // 触发WooCommerce内置更新动作，模拟后台点击Update
        do_action('woocommerce_update_product', $post_id);
        do_action('woocommerce_save_product_variation', $variation_id, $variation);
    } else {
        // Update the variation if it already exists
        $product_variable = new WC_Product_Variable($post_id);
        $product_variable->sync($post_id);
        
        // 刷新所有相关缓存
        wc_delete_product_transients($post_id);
        wp_cache_delete($product_id, 'products');
        wp_cache_delete($product_id, 'product_meta');
        
        // 触发产品更新动作
        do_action('woocommerce_update_product', $post_id);
        
        // 触发所有已有变体的保存动作
        $variations = $product_variable->get_children();
        foreach($variations as $var_id){
            $var = new WC_Product_Variation($var_id);
            do_action('woocommerce_save_product_variation', $var_id, $var);
        }
    }

    $product->save();
}

关键修改点说明 #

1. 绑定变体属性值：
   创建变体时必须明确设置set_attributes()，把变体和对应的属性术语关联起来，否则WooCommerce无法识别该变体对应的属性组合，导致前端禁用。

2. 触发内置动作钩子：

   • woocommerce_update_product：触发产品更新时的所有内部逻辑，包括更新产品状态、同步库存、刷新前端展示数据等。
   • woocommerce_save_product_variation：触发变体保存时的逻辑，确保变体的可用性状态被正确更新。

3. 彻底清除缓存：
   除了wc_delete_product_transients，还要清除WordPress的全局产品缓存，避免前端读取旧的缓存数据。

注意事项 #

• 替换代码中的'any'为你实际的“任意颜色”、“任意尺寸”术语的slug（可以在WooCommerce后台的属性术语列表中查看）。
• 确保你的属性（pa_farge、pa_str）已经在WooCommerce中设置为“用于变体”的属性。

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