WooCommerce产品变体重排时自定义字段数据异常Bug

核心问题根源 #

你当前的代码错误地将循环索引（$loop/$i）作为自定义字段元数据键名的一部分（比如skyler_stock_digital[0]）。当你新增变体、调整变体排序时，循环索引会重新分配，导致原本绑定到某个变体的元数据，被错误地关联到了新索引对应的变体上，这就是数据错乱的直接原因。

修复后的完整代码 #

1. 自定义字段渲染函数

// 挂钩到变体库存选项区域渲染字段，可根据需求更换为woocommerce_variation_options_pricing等其他钩子
add_action('woocommerce_variation_options_inventory', 'add_custom_variation_fields', 10, 3);
function add_custom_variation_fields($loop, $variation_data, $variation)
{
    // 字段键名对应显示标签，更直观
    $fields = array(
        'skyler_stock_digital' => 'Digital库存',
        'skyler_stock_vitrine_mall' => 'Vitrine Mall库存',
        'skyler_stock_center_um' => 'Center Um库存',
        'skyler_stock_aldeota' => 'Aldeota库存',
    );

    echo '<div class="custom-variation-fields-container">';

    foreach ($fields as $field_key => $field_label) {
        echo '<div class="custom-variation-field">';
        woocommerce_wp_text_input(
            array(
                'id'    => "{$field_key}_{$variation->ID}",
                'name'  => "{$field_key}[{$variation->ID}]",
                'value' => get_post_meta($variation->ID, $field_key, true) ?: 0,
                'label' => __($field_label, 'woocommerce'),
                'type'  => 'number', // 库存字段建议用数字类型，避免非数值输入
            )
        );
        echo '</div>';
    }

    echo '</div>';
}

2. 字段保存函数

add_action('woocommerce_admin_process_variation_object', 'save_custom_variation_fields', 10, 2);
function save_custom_variation_fields($variation, $i)
{
    $field_keys = array('skyler_stock_digital', 'skyler_stock_vitrine_mall', 'skyler_stock_center_um', 'skyler_stock_aldeota');
    $variation_id = $variation->ID;

    foreach ($field_keys as $field_key) {
        // 精准获取当前变体ID对应的字段值
        $custom_value = isset($_POST[$field_key][$variation_id]) ? sanitize_text_field($_POST[$field_key][$variation_id]) : '';
        
        // 处理空值：空值删除元数据，非空则更新
        if (empty($custom_value)) {
            $variation->delete_meta_data($field_key);
        } else {
            $variation->update_meta_data($field_key, $custom_value);
        }
    }
}

关键改动点说明 #

• 元数据去索引绑定：不再用循环索引关联元数据，直接用字段名绑定到变体ID，确保每个变体的自定义数据始终和自身ID绑定，不受排序/新增操作影响。
• 字段命名规范：输入框name改为字段名[变体ID]，保存时通过变体ID精准匹配对应值，彻底避免索引错位问题。
• 钩子修正：给字段渲染函数添加了正确的动作钩子（woocommerce_variation_options_inventory），确保字段能正常显示在变体编辑区域。
• 输入类型优化：将库存字段设为number类型，符合业务场景，防止无效输入。
• 空值处理：主动删除空值对应的元数据，避免无效数据残留。

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