迁移近6k产品后WooCommerce变体功能异常求自动化修复方案

问题背景 #

• 迁移近6000个产品后，部分使用IconicWP Attribute Swatches & Product Configurator插件的可变产品，选择颜色色板时无法更新配置器图片、高亮选中项，前端控制台报错
• 调试JS代码发现variation_attributes存在null值
• 手动修复流程有效但效率极低：逐个取消变体「Enabled」选项→保存产品→重新勾选「Enabled」→再次保存产品，批量操作无效果

自动化修复方案 #

核心思路是模拟手动修复的完整流程：遍历目标可变产品，先禁用所有变体并保存产品，再重新启用所有变体并再次保存产品，同时加入分批处理逻辑避免服务器负载过高。

代码实现（添加到主题functions.php） #

if (!function_exists('write_log')) {
    function write_log($log) {
        if (true === WP_DEBUG) {
            if (is_array($log) || is_object($log)) {
                error_log(print_r($log, true));
            } else {
                error_log($log);
            }
        }
    }
}

// 仅在后台执行，且通过URL参数触发，避免自动重复运行
add_action('admin_init', 'auto_fix_variation_status');

function auto_fix_variation_status() {
    // 仅允许管理员操作，防止未授权访问
    if (!current_user_can('manage_options') || !isset($_GET['fix_variations'])) {
        return;
    }

    $batch_size = 50; // 每批处理产品数量，可根据服务器性能调整
    $offset = isset($_GET['offset']) ? intval($_GET['offset']) : 0;

    // 查询需要处理的可变产品
    $variable_product_ids = get_posts(array(
        'post_type'      => 'product',
        'post_status'    => 'publish',
        'fields'         => 'ids',
        'numberposts'    => $batch_size,
        'offset'         => $offset,
        'tax_query'      => array(
            array(
                'taxonomy' => 'product_type',
                'field'    => 'slug',
                'terms'    => 'variable',
            )
        ),
        // 可选：添加筛选条件，仅处理使用IconicWP插件的产品
        // 'meta_query' => array(
        //     array(
        //         'key' => '_iconic_attribute_swatches_enabled',
        //         'value' => 'yes',
        //         'compare' => '='
        //     )
        // )
    ));

    if (empty($variable_product_ids)) {
        write_log('所有目标可变产品已处理完成');
        echo '<div class="notice notice-success"><p>所有目标可变产品已处理完成</p></div>';
        return;
    }

    $random_id = wp_rand();
    $start_time = current_datetime()->format('Y-m-d H:i:s');
    write_log("{$random_id} | {$start_time} | 开始处理批次，偏移量：{$offset}，产品数量：" . count($variable_product_ids));

    foreach ($variable_product_ids as $product_id) {
        $product = wc_get_product($product_id);
        if (!$product || !$product->is_type('variable')) {
            continue;
        }

        // 第一步：禁用所有变体
        $variations = $product->get_children();
        foreach ($variations as $variation_id) {
            $variation = wc_get_product($variation_id);
            if ($variation && $variation->is_enabled()) {
                $variation->set_status('private');
                $variation->save();
            }
        }
        $product->save();

        // 第二步：重新启用所有变体
        foreach ($variations as $variation_id) {
            $variation = wc_get_product($variation_id);
            if ($variation && !$variation->is_enabled()) {
                $variation->set_status('publish');
                $variation->save();
            }
        }
        $product->save();

        write_log("已完成产品ID：{$product_id} 的修复");
    }

    $end_time = current_datetime()->format('Y-m-d H:i:s');
    write_log("{$random_id} | {$end_time} | 当前批次处理完成");

    // 生成下一批处理的跳转链接
    $next_offset = $offset + $batch_size;
    $next_url = admin_url("?fix_variations=1&offset={$next_offset}");
    echo '<div class="notice notice-info"><p>当前批次处理完成，<a href="' . esc_url($next_url) . '">点击处理下一批</a></p></div>';
}

使用步骤 #

1. 将代码添加到当前主题的functions.php文件中
2. 确保wp-config.php中开启了WP_DEBUG（define('WP_DEBUG', true);），方便查看处理日志
3. 登录WordPress后台，访问wp-admin/?fix_variations=1开始处理，每批完成后点击页面提示的链接处理下一批
4. 所有产品处理完成后，记得移除这段代码，避免误触发

注意事项 #

• 根据服务器性能调整$batch_size，建议从20-50开始测试，防止超时
• 可通过meta_query筛选仅处理使用IconicWP插件的产品，减少无效操作
• 执行前建议备份数据库，避免意外问题

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