WooCommerce中set_default_attributes无效，如何正确设置产品默认属性？

你的思路方向是对的，但set_default_attributes的使用和触发时机存在问题，导致没有生效：

核心问题点 #

1. wp_footer触发时机不合适：这个钩子是前端页面底部输出内容时触发，属于前端渲染阶段，此时修改产品数据不仅可能因权限或执行逻辑问题不生效，还会额外消耗前端性能。
2. 缺少关键保存步骤：调用set_default_attributes后，必须调用产品对象的save()方法，才能将修改写入数据库。
3. 可能未准确定位尺码属性：如果没有获取到尺码对应的属性 taxonomy（通常是pa_size），设置的默认属性不会生效。

单个产品测试的修正代码 #

建议在后台环境执行测试，避免前端触发的问题，代码示例如下：

add_action('admin_init', 'set_first_size_as_default_for_test_product');
function set_first_size_as_default_for_test_product() {
    // 仅管理员可执行，且通过URL参数触发（避免每次后台加载都执行）
    if (!current_user_can('manage_options') || !isset($_GET['test_set_default_size'])) {
        return;
    }

    // 替换为你要测试的产品ID
    $product_id = 123;
    $product = wc_get_product($product_id);

    // 仅处理可变产品
    if (!$product || !$product->is_type('variable')) {
        wp_die('目标不是可变产品');
    }

    // 尺码属性的默认slug是pa_size，若你自定义了属性slug请替换
    $size_attr_slug = 'pa_size';
    $attributes = $product->get_attributes();

    // 检查产品是否包含尺码属性
    if (!isset($attributes[$size_attr_slug])) {
        wp_die('该产品未配置尺码属性');
    }

    $size_attribute = $attributes[$size_attr_slug];
    // 获取该属性下的所有尺码选项
    $size_terms = $size_attribute->get_terms();

    if (empty($size_terms)) {
        wp_die('尺码属性无可用选项');
    }

    // 设置第一个尺码为默认属性
    $default_attrs = array(
        $size_attr_slug => $size_terms[0]->slug
    );

    // 保存修改到数据库
    $product->set_default_attributes($default_attrs);
    $product->save();

    wp_die('已成功将第一个尺码设为默认属性');
}

使用方法：

• 将代码添加到主题functions.php或自定义插件中
• 登录后台后，在任意后台页面URL后追加?test_set_default_size=1（如wp-admin/index.php?test_set_default_size=1）触发执行
• 测试完成后立即删除这段代码，避免重复触发

批量处理所有产品的代码 #

如果需要遍历全店带尺码的可变产品，可使用以下代码：

add_action('admin_init', 'batch_set_first_size_as_default');
function batch_set_first_size_as_default() {
    if (!current_user_can('manage_options') || !isset($_GET['batch_set_default_size'])) {
        return;
    }

    // 查询所有已发布的可变产品
    $args = array(
        'post_type' => 'product',
        'post_status' => 'publish',
        'posts_per_page' => -1,
        'tax_query' => array(
            array(
                'taxonomy' => 'product_type',
                'field' => 'slug',
                'terms' => 'variable'
            )
        )
    );

    $products = new WP_Query($args);
    $modified_count = 0;

    if ($products->have_posts()) {
        while ($products->have_posts()) {
            $products->the_post();
            $product = wc_get_product(get_the_ID());
            $size_attr_slug = 'pa_size';
            $attributes = $product->get_attributes();

            // 跳过无尺码属性的产品
            if (!isset($attributes[$size_attr_slug])) {
                continue;
            }

            $size_attribute = $attributes[$size_attr_slug];
            $size_terms = $size_attribute->get_terms();

            // 跳过无尺码选项的产品
            if (empty($size_terms)) {
                continue;
            }

            // 设置默认属性并保存
            $default_attrs = array(
                $size_attr_slug => $size_terms[0]->slug
            );
            $product->set_default_attributes($default_attrs);
            $product->save();
            $modified_count++;
        }
        wp_reset_postdata();
    }

    wp_die('批量处理完成，共修改'.$modified_count.'个带尺码属性的可变产品');
}

关键注意事项 #

• 确认尺码属性slug：默认是pa_size，若你自定义了属性slug，需替换为对应值
• 批量处理前务必备份数据库，避免数据错误
• 执行完脚本后立即删除代码，防止误触发

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