WooCommerce插件修改产品属性失败，求解决及错误排查方法

你的代码失效的核心原因是set_attributes方法不接受简单的「属性slug-术语slug」键值对，它需要符合WooCommerce产品属性结构的数组（或WC_Product_Attribute对象数组）。下面是具体排查方案和正确代码：

一、先排查隐藏问题 #

1. 开启WordPress调试模式
   在wp-config.php中添加以下代码，捕获隐藏的错误信息：

   define('WP_DEBUG', true);
   define('WP_DEBUG_LOG', true);
   define('WP_DEBUG_DISPLAY', false);
   

   错误日志会生成在wp-content/debug.log中，帮你定位产品获取失败、属性/术语不存在等问题。

2. 验证产品对象是否获取成功
   在代码开头添加判断，避免产品ID错误导致后续操作无效：

   $product = wc_get_product(28);
   if (!$product) {
       error_log('无法获取产品ID 28');
       return;
   }
   

3. 确认属性与术语的有效性
   检查属性和术语是否存在：

   // 检查pa_mat属性是否存在
   if (!wc_get_attribute('pa_mat')) {
       error_log('属性pa_mat不存在');
   }
   // 检查术语mg是否属于pa_mat
   if (!get_term_by('slug', 'mg', 'pa_mat')) {
       error_log('术语mg不存在于pa_mat属性中');
   }
   

二、正确的属性修改代码 #

方法1：使用WC_Product_Attribute对象（推荐，结构更清晰） #

$product = wc_get_product(28);
if (!$product) {
    error_log('无法获取产品ID 28');
    return;
}

$attributes = [];

// 处理Matière属性
$mat_attr = wc_get_attribute('pa_mat');
$mat_term = get_term_by('slug', 'mg', 'pa_mat');
if ($mat_attr && $mat_term) {
    $mat_product_attr = new WC_Product_Attribute();
    $mat_product_attr->set_id($mat_attr->get_id());
    $mat_product_attr->set_name('pa_mat');
    $mat_product_attr->set_options([$mat_term->term_id]); // 必须传术语ID，而非slug
    $mat_product_attr->set_visible(true); // 是否在前端显示
    $mat_product_attr->set_variation(false); // 是否用于产品变体，按需调整
    $attributes[] = $mat_product_attr;
}

// 处理Composition属性
$compo_attr = wc_get_attribute('pa_compo');
$compo_term = get_term_by('slug', '1s1', 'pa_compo');
if ($compo_attr && $compo_term) {
    $compo_product_attr = new WC_Product_Attribute();
    $compo_product_attr->set_id($compo_attr->get_id());
    $compo_product_attr->set_name('pa_compo');
    $compo_product_attr->set_options([$compo_term->term_id]);
    $compo_product_attr->set_visible(true);
    $compo_product_attr->set_variation(false);
    $attributes[] = $compo_product_attr;
}

// 设置并保存属性
$product->set_attributes($attributes);
$product->save();

方法2：使用数组结构（更简洁） #

$product = wc_get_product(28);
if (!$product) {
    error_log('无法获取产品ID 28');
    return;
}

// 获取术语ID
$mg_term_id = get_term_by('slug', 'mg', 'pa_mat')->term_id;
$compo_term_id = get_term_by('slug', '1s1', 'pa_compo')->term_id;

// 构造符合要求的属性数组
$attributes = [
    'pa_mat' => [
        'name' => 'pa_mat',
        'value' => $mg_term_id,
        'is_visible' => true,
        'is_variation' => false,
        'is_taxonomy' => true // 全局属性必须设为true
    ],
    'pa_compo' => [
        'name' => 'pa_compo',
        'value' => $compo_term_id,
        'is_visible' => true,
        'is_variation' => false,
        'is_taxonomy' => true
    ]
];

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

关键注意事项 #

• 全局产品属性的slug必须带pa_前缀，比如mat对应pa_mat
• 属性选项必须传入术语ID，而不是术语slug
• 全局属性必须设置is_taxonomy为true，否则无法正确保存
• 如果是多属性值，options或value字段需要传数组（比如[$term_id1, $term_id2]）

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