WooCommerce 7.5.1可变产品非分类属性变体编程异常求助

我在通过代码给WooCommerce 7.5.1的可变产品添加非分类属性和变体时遇到两个问题：

• 前端能显示产品属性，但选择属性后始终跳转到同一个错误变体；
• 后端编辑产品时，能看到正确的属性和变体，但变体未关联对应的属性值，手动给某个变体选择对应值时，其他变体的属性值会丢失。

手动操作完全正常，找不到问题原因，以下是出问题的代码片段：

// **** Product Object and its properties
$obProducto=new WC_Product_Variable();
$obProducto->set_sku('SOME_SKU');
$obProducto->set_name('Some Title');
$obProducto->set_short_description('Some short description');
$obProducto->set_description('Some long description');
$obProducto->set_regular_price('99,99');
$obProducto->set_sale_price('59,99');
$obProducto->set_manage_stock(true);
$obProducto->set_sold_individually(true);
$obProducto->set_backorders('no');
$obProducto->set_stock_status('instock');
$obProducto->set_stock_quantity('1500');
$obProducto->set_low_stock_amount('50');

// **** Attribute to be assigned to the product object
$attribute = new WC_Product_Attribute();
$attribute->set_id(0);
$attribute->set_name( 'ContenidoNeto' );
$attribute->set_options( array( '100ml', '200ml' ) );
$attribute->set_position( 1 );
$attribute->set_visible( 1 );
$attribute->set_variation( 1 );
$attributes[] = $attribute;
$obProducto->set_attributes( $attributes );
$obProducto->save();

// **** The two variations
$variation1 = new WC_Product_Variation();
$variation1->set_parent_id( $obProducto->get_id() );
$variation1->save();
$variation1->set_attributes( array( 'ContenidoNeto' => '100ml' ) );
$variation1->set_regular_price( 9999.99 );
$variation1->save();

$variation2 = new WC_Product_Variation();
$variation2->set_parent_id( $obProducto->get_id() );
$variation2->save();
$variation2->set_attributes( array( 'ContenidoNeto' => '200ml' ) );
$variation2->set_regular_price( 8888.88 );
$variation2->save();

问题根源 #

1. 属性存储格式错误：WooCommerce非全局属性的set_options()需要传入属性值的slug（小写无特殊字符格式），而非原始文本；变体关联属性时也必须使用对应slug，否则无法匹配。
2. 变体属性设置时机错误：先保存变体再设置属性，会导致WooCommerce无法正确关联属性值到变体。
3. 价格格式问题：set_regular_price()等方法需要用点号.作为小数点分隔符，而非逗号,，否则会导致价格解析异常。

修正后的代码 #

// 创建可变产品对象
$obProducto = new WC_Product_Variable();
$obProducto->set_sku('SOME_SKU');
$obProducto->set_name('Some Title');
$obProducto->set_short_description('Some short description');
$obProducto->set_description('Some long description');
$obProducto->set_regular_price('99.99'); // 修正小数点格式
$obProducto->set_sale_price('59.99');
$obProducto->set_manage_stock(true);
$obProducto->set_sold_individually(true);
$obProducto->set_backorders('no');
$obProducto->set_stock_status('instock');
$obProducto->set_stock_quantity('1500');
$obProducto->set_low_stock_amount('50');

// 定义属性及对应slug
$attribute_name = 'ContenidoNeto';
$attribute_slugs = array('100ml', '200ml'); // 此处值本身符合slug规则，直接使用

// 创建产品属性
$attribute = new WC_Product_Attribute();
$attribute->set_id(0);
$attribute->set_name($attribute_name);
$attribute->set_options($attribute_slugs); // 传入slug数组
$attribute->set_position(1);
$attribute->set_visible(1);
$attribute->set_variation(1);
$attributes[] = $attribute;

$obProducto->set_attributes($attributes);
$obProducto->save();

// 创建变体1：先设置属性再保存
$variation1 = new WC_Product_Variation();
$variation1->set_parent_id($obProducto->get_id());
// 非全局属性需加pa_前缀
$variation1->set_attributes(array('pa_' . $attribute_name => '100ml'));
$variation1->set_regular_price(9999.99);
$variation1->set_stock_status('instock');
$variation1->save();

// 创建变体2：先设置属性再保存
$variation2 = new WC_Product_Variation();
$variation2->set_parent_id($obProducto->get_id());
$variation2->set_attributes(array('pa_' . $attribute_name => '200ml'));
$variation2->set_regular_price(8888.88);
$variation2->set_stock_status('instock');
$variation2->save();

关键修正点说明 #

• 属性前缀与slug：非全局属性在变体中必须使用pa_前缀（如pa_ContenidoNeto），属性值需匹配产品属性中设置的slug。
• 变体保存顺序：先设置父ID和属性，再执行save()，确保WooCommerce能正确关联属性元数据。
• 价格格式：统一使用点号作为小数点分隔符，避免价格解析错误。

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