WooCommerce产品变体Tax Query查询无结果问题排查

你的查询返回空是WooCommerce产品属性的底层存储逻辑导致的，不属于配置疏漏：

• 所有pa_前缀的自定义产品属性属于WordPress自定义分类法，这类分类法默认仅和product（主产品，含可变产品）文章类型绑定关联，不会直接关联product_variation（产品变体）类型的文章
• 你写的tax_query会去数据库查询product_variation和pa_billing-period分类法的绑定关系，但这类关系在WooCommerce默认逻辑下根本不存在，自然返回空结果。
• 移除tax_query后查询仅按post_parent匹配子文章，所以能正常返回父产品下的4个变体，也说明除了分类查询部分，其余参数本身没有语法错误。

另外你确实漏了一个基础查询参数：post_status，默认查询虽然会优先取发布状态内容，但WooCommerce的变体存在大量自动生成的草稿、待审、回收站状态数据，不加这个参数很容易出现结果不符合预期的问题。

方案1：改用meta_query匹配变体属性（兼容原生get_posts） #

WooCommerce会把每个变体对应的属性值，存在变体的post meta表中，键名格式为attribute_pa_+属性slug，存储的值就是属性项的slug，直接替换tax_query为meta_query即可：

global $post;
$product_id = $post->ID;
$args = array(
    'post_type'      => array('product_variation'),
    'posts_per_page' => -1,
    'post_parent'    => 177,
    'post_status'    => 'publish',
    'meta_query'     => array(
        array(
            'key'     => 'attribute_pa_billing-period',
            'value'   => 'yearly',
            'compare' => '='
        )
    ),
);

$variations = get_posts( $args ); 
echo "<pre>"; print_r($variations); echo "</pre>";

方案2：使用WooCommerce官方查询函数（版本兼容性更好） #

WooCommerce官方不推荐直接用get_posts查询产品、变体数据，封装的wc_get_products会自动处理属性关联、多语言、权限校验等兼容逻辑，直接传属性查询参数即可：

$args = array(
    'type'       => 'variation',
    'parent_id'  => 177,
    'limit'      => -1,
    'status'     => 'publish',
    'attributes' => array(
        array(
            'taxonomy' => 'pa_billing-period',
            'terms'    => 'yearly',
            'field'    => 'slug',
        )
    )
);
$variations = wc_get_products( $args );
echo "<pre>"; print_r($variations); echo "</pre>";

• 不要手动修改分类法注册参数给product_variation绑定pa_属性分类法，会破坏WooCommerce原生的属性存储、价格筛选、库存同步逻辑，后续版本升级、第三方插件兼容都会出问题
• 如果改完还是查不到结果，先去后台编辑父产品，确认对应yearly计费周期的变体是已发布状态，不是“草稿”“待审核”“回收站”状态

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