使用WooCommerce CRUD创建可变产品时第二个属性未生成问题咨询

你遇到的问题主要来自三个核心错误：

1. 属性ID赋值错误 #

你直接用count($allProductAttributes)生成的0、1这类数值作为属性ID，但WooCommerce对属性ID有严格规则：

• 全局可复用属性的ID是wp_woocommerce_attribute_taxonomies表中的真实ID，不能自定义。
• 产品专属的自定义属性，ID必须设为0。
  自定义的无效ID会导致WooCommerce无法正确识别第二个属性，最终被覆盖或丢弃。

2. 属性名称格式错误 #

WooCommerce的全局属性分类法名称必须以pa_为前缀（比如pa_colour、pa_size），你直接使用显示名称“Colour”“Size”，会导致属性无法被识别为合法的全局属性。

3. 未设置属性位置 #

你的createWooCommerceProductAttribute方法没有给属性设置position值，虽然不会直接导致属性丢失，但会影响后台显示顺序，属于不规范写法。

修正后的代码 #

方案一：使用全局属性（推荐，支持复用与筛选） #

这种方式会自动创建/复用WooCommerce全局属性，属性可在其他产品中重复使用，也支持前台筛选：

/**
 * Create a product using a ImportProductModel
 *
 * @param importProductModel $productModel The product to create
 *
 * @return int|WP_Error The product ID on success, or WP_Error on failure.
 * @throws WC_Data_Exception
 */
public static function createWooCommerceProduct(importProductModel $productModel): WP_Error|int {
    $WCProduct = new WC_Product_Variable();
    $WCProduct->set_name($productModel->getProductName());
    $WCProduct->set_sku($productModel->getCode());

    $allProductAttributes = [];

    $allColors = $productModel->getAllColors();
    $allSizes = $productModel->getAllSizes();

    if(!empty($allColors)){
        $position = count($allProductAttributes);
        $colorAttribute = self::createWooCommerceProductAttribute('colour', 'Colour', explode("|", $allColors), $position);
        $allProductAttributes[] = $colorAttribute;
    }

    if(!empty($allSizes)){
        $position = count($allProductAttributes);
        $sizeAttribute = self::createWooCommerceProductAttribute('size', 'Size', explode("|", $allSizes), $position);
        $allProductAttributes[] = $sizeAttribute;
    }

    $WCProduct->set_attributes($allProductAttributes);
    $WCProductId = $WCProduct->save();

    update_post_meta($WCProductId, 'importProductModelId', $productModel->getProductId());

    return $WCProductId;
}

/**
 * Create a Attribute for a WooCommerce Product
 * @param string $slug Attribute slug (without pa_ prefix)
 * @param string $name Attribute display name
 * @param array $values Attribute values
 * @param int $position Attribute position
 * @return WC_Product_Attribute The created attribute
 */
private static function createWooCommerceProductAttribute(string $slug, string $name, array $values, int $position): WC_Product_Attribute {
    // 获取全局属性ID，不存在则自动创建
    $attribute_id = wc_attribute_taxonomy_id_by_name($slug);
    if (!$attribute_id) {
        $attribute = wc_create_attribute([
            'name'         => $name,
            'slug'         => $slug,
            'type'         => 'select',
            'order_by'     => 'menu_order',
            'has_archives' => false,
        ]);
        $attribute_id = $attribute->id;
    }

    $product_attribute = new WC_Product_Attribute();
    $product_attribute->set_name('pa_' . $slug); // 必须带pa_前缀
    $product_attribute->set_id($attribute_id); // 使用真实的全局属性ID
    $product_attribute->set_options($values);
    $product_attribute->set_visible(true);
    $product_attribute->set_variation(true);
    $product_attribute->set_position($position);

    return $product_attribute;
}

方案二：使用产品专属自定义属性 #

如果不需要全局复用属性，可使用这种方式，属性仅属于当前产品：

// 修改createWooCommerceProductAttribute方法
private static function createWooCommerceProductAttribute(string $name, array $values, int $position): WC_Product_Attribute {
    $product_attribute = new WC_Product_Attribute();
    $product_attribute->set_name($name); // 直接用显示名称
    $product_attribute->set_id(0); // 自定义属性ID必须为0
    $product_attribute->set_options($values);
    $product_attribute->set_visible(true);
    $product_attribute->set_variation(true);
    $product_attribute->set_position($position);

    return $product_attribute;
}

// 调用时只需传名称、值、位置
$colorAttribute = self::createWooCommerceProductAttribute('Colour', explode("|", $allColors), $position);

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