WooCommerce产品属性添加后为空，Post Meta不显示如何解决？

我之前处理过一模一样的问题，你遇到的核心问题是WooCommerce的_product_attributes元数据要求特定的嵌套数组结构，而你当前的代码用了一维数组，导致系统无法正确解析属性信息，所以才会出现字段名称和值都为空的情况，而且因为语法上没有错误，所以不会抛出报错。

先看你提供的代码：

update_post_meta( $post->ID , '_product_attributes', [ 
    'name' => 'Size', 
    'value' => 'S|M|L', 
    'position' => 0, 
    'is_visible' => 1, 
    'is_variation' => 1, 
    'is_taxonomy' => 1 
] );

这段代码有两个关键问题：

1. 缺少属性slug作为外层数组的键：WooCommerce要求每个产品属性都要以它的slug（比如分类属性默认是pa_size）作为键来包裹属性配置
2. is_taxonomy设为1时，value字段不能直接填选项值：分类式属性的选项是通过WordPress术语系统管理的，value需要留空，后续用wp_set_object_terms来关联具体的属性值

下面分两种场景给你正确的实现方案：

场景1：使用已注册的分类式产品属性（适合需要变体的属性，比如Size） #

如果你的Size属性已经在WooCommerce后台注册为产品属性（slug为pa_size），可以这么写：

// 构建符合要求的属性数组，用属性slug作为键
$product_attributes = [
    'pa_size' => [
        'name' => 'Size',
        'value' => '', // 分类属性的value必须留空
        'position' => 0,
        'is_visible' => 1,
        'is_variation' => 1, // 允许作为变体属性
        'is_taxonomy' => 1
    ]
];

// 更新产品属性元数据
update_post_meta( $post->ID, '_product_attributes', $product_attributes );

// 给产品关联具体的属性值（比如S），需要用wp_set_object_terms
wp_set_object_terms( $post->ID, 's', 'pa_size', false );

场景2：使用自定义非分类属性（不需要后台注册，适合一次性属性） #

如果只是想添加一个自定义的非分类属性，不需要作为变体使用，可以这么写：

$product_attributes = [
    'custom_size' => [ // 自定义键名，不需要pa_前缀
        'name' => 'Size',
        'value' => 'S|M|L', // 直接用|分隔多个选项值
        'position' => 0,
        'is_visible' => 1,
        'is_variation' => 0, // 非分类属性不能作为变体
        'is_taxonomy' => 0
    ]
];

update_post_meta( $post->ID, '_product_attributes', $product_attributes );

额外注意事项 #

如果是要更新已有产品的属性，不要直接覆盖整个_product_attributes数组，最好先获取现有属性，合并新属性后再更新，避免丢失原有属性：

// 获取现有属性，为空则设为空数组
$existing_attributes = get_post_meta( $post->ID, '_product_attributes', true ) ?: [];

// 新属性配置
$new_attribute = [
    'pa_size' => [
        'name' => 'Size',
        'value' => '',
        'position' => 0,
        'is_visible' => 1,
        'is_variation' => 1,
        'is_taxonomy' => 1
    ]
];

// 合并属性
$updated_attributes = array_merge( $existing_attributes, $new_attribute );

// 更新元数据
update_post_meta( $post->ID, '_product_attributes', $updated_attributes );

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