WooCommerce库存联动问题：商品X缺货时商品Y未自动同步缺货状态

需求：当商品X（Item X）变为缺货状态时，自动将商品Y（Item Y）的库存状态更新为“缺货”。

问题：替换测试商品ID后，将商品X设置为缺货，但商品Y仍保持有货状态，无论商品Y是否开启库存数量管理，结果均一致。

用户代码：

/* Conditional inventory tracking. If Item X is out of stock, make Item Y out of stock also */

function update_related_product_stock( $product_id ) {
    // Check if the product is Item X or Item Y
    if ( $product_id == 123 || $product_id == 456 ) { // Replace 123 and 456 with the actual product IDs of Item X and Item Y
        $item_1_stock = get_post_meta( 123, '_stock', true ); // Replace 123 with the actual product ID of Item X

        // Update stock of Item Y based on stock of Item X
        if ( $item_1_stock <= 0 ) {
            update_post_meta( 456, '_stock_status', 'outofstock' ); // Replace 456 with the actual product ID of Item Y
        } else {
            update_post_meta( 456, '_stock_status', 'instock' ); // Replace 456 with the actual product ID of Item Y
        }
    }
}
// Hook the function to run when stock levels are updated
add_action( 'woocommerce_product_set_stock', 'update_related_product_stock' );

问题分析与解决方向 #

1. 钩子触发范围有限 #

woocommerce_product_set_stock仅在通过set_stock()方法修改库存数量时触发，无法覆盖以下场景：

• 后台手动直接修改商品库存状态（不改动库存数量）
• 订单完成/取消导致的库存自动调整
• 批量修改库存操作

需要替换为覆盖范围更广的钩子，同时监听库存数量变动和库存状态修改事件。

2. 直接修改元数据未触发WooCommerce内部机制 #

直接用update_post_meta()修改_stock_status元数据，不会触发WooCommerce的库存同步逻辑：

• 不会更新产品缓存
• 可变产品的变体状态不会同步
• 相关库存钩子不会触发，可能导致状态不一致

必须使用WooCommerce提供的WC_Product类方法来更新库存状态。

3. 逻辑判断不准确 #

仅通过_stock数值判断缺货，忽略了以下情况：

• 商品未启用库存管理时，_stock字段可能为空或无效
• 手动设置库存状态为“缺货”但库存数量仍大于0的场景
• 启用“允许缺货下单”的商品，库存数量为负但状态仍为“有货”

应该直接获取商品的库存状态而非库存数值。

修正后的代码 #

/* 同步关联商品库存状态：当商品X缺货时，自动设置商品Y为缺货 */
function sync_related_product_stock_status( $product_id ) {
    // 替换为实际的商品ID
    $item_x_id = 123;
    $item_y_id = 456;

    // 仅在商品X的库存/状态变动时执行，避免循环触发
    if ( $product_id !== $item_x_id ) {
        return;
    }

    // 获取商品X的产品实例，验证有效性
    $product_x = wc_get_product( $item_x_id );
    if ( ! $product_x ) {
        return;
    }

    // 获取商品X的当前库存状态
    $stock_status_x = $product_x->get_stock_status();

    // 获取商品Y的产品实例，验证有效性
    $product_y = wc_get_product( $item_y_id );
    if ( ! $product_y ) {
        return;
    }

    // 根据商品X的状态更新商品Y
    if ( 'outofstock' === $stock_status_x ) {
        $product_y->set_stock_status( 'outofstock' );
    } else {
        $product_y->set_stock_status( 'instock' );
    }

    // 保存商品Y的更改，触发WooCommerce内部同步机制
    $product_y->save();
}

// 监听库存数量变动事件
add_action( 'woocommerce_update_product_stock', 'sync_related_product_stock_status', 10, 1 );
// 监听库存状态修改事件
add_action( 'woocommerce_product_set_stock_status', 'sync_related_product_stock_status', 10, 1 );

关键改动说明 #

• 钩子选择：同时使用woocommerce_update_product_stock和woocommerce_product_set_stock_status，覆盖所有库存变动场景
• 产品对象操作：通过wc_get_product()获取实例，用set_stock_status()和save()方法更新，确保触发缓存更新、变体同步等内部逻辑
• 避免循环触发：仅在商品X变动时执行函数，防止商品Y更新时重复触发
• 状态直接判断：使用get_stock_status()获取官方库存状态，判断逻辑更准确

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