如何批量修正WooCommerce中迁移错误的产品属性？

问题分析 #

迁移后产品属性的is_taxonomy被设为0，且value存储术语名称，导致前端不显示属性。手动保存时WooCommerce会自动完成以下操作：

1. 将is_taxonomy改为1，清空value字段
2. 在term_relationships中建立产品与属性术语的关联

WooCommerce没有内置的一键批量修正函数，但可以通过自定义脚本模拟手动保存的逻辑，批量处理所有产品。

解决方案代码 #

function fix_migrated_product_attributes() {
    // 配置产品查询参数，可按需调整（如仅处理简单产品、排除草稿等）
    $product_query_args = array(
        'post_type'      => 'product',
        'posts_per_page' => -1,
        'post_status'    => 'publish',
        'fields'         => 'ids' // 仅获取产品ID，提升处理效率
    );

    $product_ids = get_posts($product_query_args);

    foreach ($product_ids as $product_id) {
        $product = wc_get_product($product_id);
        if (!$product) continue;

        $attributes = $product->get_attributes();
        $needs_update = false;

        foreach ($attributes as $attr_slug => $attr_details) {
            // 仅处理pa前缀的分类属性，且当前为非分类属性格式的情况
            if (strpos($attr_slug, 'pa_') === 0 && $attr_details['is_taxonomy'] === 0 && !empty($attr_details['value'])) {
                // 根据术语名称获取对应术语ID（确保术语已存在）
                $target_term = get_term_by('name', $attr_details['value'], $attr_slug);
                
                if ($target_term && !is_wp_error($target_term)) {
                    // 更新属性配置：标记为分类属性，清空value
                    $attributes[$attr_slug]['is_taxonomy'] = 1;
                    $attributes[$attr_slug]['value'] = '';
                    $needs_update = true;

                    // 建立产品与属性术语的关联
                    wp_set_object_terms($product_id, $target_term->term_id, $attr_slug, true);
                }
            }
        }

        if ($needs_update) {
            // 保存更新后的属性元数据
            update_post_meta($product_id, '_product_attributes', $attributes);
            // 触发产品保存动作，确保相关数据同步
            $product->save();
        }
    }
}

// 取消注释以下代码，执行一次后重新注释，避免重复处理
// fix_migrated_product_attributes();

使用说明 #

1. 备份数据库：执行前务必备份，避免数据异常
2. 代码部署：
   • 将代码添加到当前主题的functions.php文件中
   • 或创建独立的临时插件（更安全，避免影响主题）
3. 触发执行：
   • 取消注释fix_migrated_product_attributes();，访问网站任意页面一次，执行完成后重新注释该行
   • 若产品数量较多，建议使用WP CLI执行：将代码保存为fix-attributes.php，运行wp eval-file fix-attributes.php，避免超时
4. 分批次处理：如果产品数量极大，可修改posts_per_page为50/100，多次执行直到所有产品处理完成

注意事项 #

• 确保所有属性术语已存在于对应属性分类中，否则脚本会跳过该属性的修正
• 脚本会自动处理变体属性（is_variation=1），无需额外修改
• 执行后可随机查看几个产品的前台页面和编辑页面，验证属性是否正常显示

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