WooCommerce根据父商品postmeta值更新变体库存状态问题

问题原因 #

你挂载的woocommerce_product_set_stock、woocommerce_variation_set_stock、woocommerce_update_product均属于库存/产品更新流程中的前置/中置钩子，WooCommerce核心的库存状态同步逻辑会在这些钩子执行完成后自动覆盖你写入的_stock_status字段值，所以会出现修改后立刻被重置的情况。

最优解决方案：动态过滤库存状态 #

不直接修改数据库字段，通过woocommerce_product_get_stock_status钩子动态判断变体的库存状态，不会被核心逻辑覆盖，代码示例如下：

add_filter( 'woocommerce_product_get_stock_status', 'custom_variation_stock_status_by_parent_weight', 10, 2 );
add_filter( 'woocommerce_product_variation_get_stock_status', 'custom_variation_stock_status_by_parent_weight', 10, 2 );
function custom_variation_stock_status_by_parent_weight( $status, $product ) {
    // 仅处理变体产品
    if ( ! $product->is_type( 'variation' ) ) {
        return $status;
    }
    // 获取父产品
    $parent_product = wc_get_product( $product->get_parent_id() );
    if ( ! $parent_product || ! $parent_product->managing_stock() ) {
        return $status;
    }
    // 获取变体克重乘数、父产品当前库存
    $multiplier = $product->get_meta( '_stock_multiplier', true );
    $parent_stock = $parent_product->get_stock_quantity();
    
    // 库存不足则返回缺货状态
    if ( $multiplier && $parent_stock < intval( $multiplier ) ) {
        return 'outofstock';
    }
    return $status;
}

可选方案：后置钩子写入数据库 #

如果需要将状态持久化写入数据库，可挂载woocommerce_after_product_object_save钩子，该钩子在产品所有数据保存完成后触发，不会被核心逻辑覆盖，代码示例如下：

add_action( 'woocommerce_after_product_object_save', 'custom_save_variation_stock_status', 10, 2 );
function custom_save_variation_stock_status( $product, $data_store ) {
    if ( ! $product->is_type( 'variation' ) ) {
        return;
    }
    $parent_product = wc_get_product( $product->get_parent_id() );
    if ( ! $parent_product || ! $parent_product->managing_stock() ) {
        return;
    }
    $multiplier = $product->get_meta( '_stock_multiplier', true );
    $parent_stock = $parent_product->get_stock_quantity();
    $expected_status = $multiplier && $parent_stock < intval( $multiplier ) ? 'outofstock' : 'instock';
    
    // 状态不一致时才更新，避免循环触发
    if ( $product->get_stock_status() !== $expected_status ) {
        $product->set_stock_status( $expected_status );
        $product->save();
    }
}

注意事项 #

• 动态过滤方案无需额外处理缓存，实时生效，更推荐使用
• 如果站点开启了页面静态缓存或者WooCommerce产品缓存，修改代码后需要清空对应缓存才能看到效果
• 请确保变体的_stock_multiplier字段值为有效数字，避免判断逻辑出错

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