如何在WooCommerce中获取所有启用状态的可变产品变体？

问题说明 #

需要获取所有status字段为publish（即勾选「启用」）的可变产品变体，此前尝试的几种方案均存在问题：

• 方案1：$product->get_children($args)返回所有变体，包含status为private的结果
• 方案2：wc_get_products($args)未返回任何变体
• 方案3：get_available_variations()和get_visible_children()仅返回部分publish状态的变体，部分库存>0的变体会被排除

正确实现方式 #

方式一：遍历所有变体并筛选状态 #

通过产品对象获取所有变体ID，逐个验证状态：

// 假设$product是已实例化的可变产品对象
$all_variation_ids = $product->get_children();
$published_variations = [];

foreach ($all_variation_ids as $variation_id) {
    $variation = wc_get_product($variation_id);
    if ($variation && $variation->get_status() === 'publish') {
        $published_variations[] = $variation;
    }
}

该方法直接遍历所有变体，通过get_status()精准判断是否为「启用」状态，不受库存、可见性等其他条件干扰。

方式二：修正wc_get_products的参数 #

此前方案2因缺少必要参数导致失败，正确写法需指定变体类型：

$args = array(
    'parent' => $product_id,
    'status' => 'publish',
    'type' => 'variation', // 必须指定查询类型为变体
    'limit' => -1, // 获取所有匹配结果，不限制数量
);
$published_variations = wc_get_products($args);

添加type => 'variation'后，wc_get_products会正确查询父产品下的变体，limit => -1确保返回所有符合条件的结果。

旧方案问题原因 #

• get_children($args)的status参数不生效，该方法默认返回所有子变体ID，忽略状态筛选
• wc_get_products未指定type时，默认查询简单产品等类型，不会返回变体
• get_available_variations()和get_visible_children()会额外判断库存状态、前端可见性等条件，仅返回可购买的变体，而非所有启用的变体

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