WooCommerce待付款订单库存占用问题优化方案咨询

方案对比与选择 #

方案1：修改Pending Payment状态直接扣减库存 #

• 优势：库存数据完全真实，彻底避免用户看到的库存与实际可售量不符的问题，从根源上杜绝超卖风险。
• 劣势：需额外处理库存回滚场景（订单取消、支付失败、超时未付款等），逻辑复杂，稍不注意容易导致库存异常。

方案2：调整库存显示为「实际库存 - 待付款占用量」 #

• 优势：仅修改前端显示逻辑，保留WooCommerce原生的库存锁定机制（防止并发下单超卖），实现成本低，用户体验更顺畅。
• 劣势：本质上待付款订单仍占用库存，但用户感知不到冲突，核心库存逻辑未改动。

推荐选择方案2，因为它兼顾用户体验和系统稳定性，无需处理复杂的库存回滚逻辑，适合大多数场景。

方案2具体实现代码 #

将以下代码添加到当前主题的functions.php文件中，或使用自定义代码插件（如Code Snippets）添加，避免主题更新丢失代码：

// 计算指定商品在所有待付款订单中的占用库存总量
function get_pending_order_stock_qty( $product_id ) {
    $pending_qty = 0;
    // 获取所有待付款状态的订单ID
    $pending_orders = wc_get_orders( array(
        'status' => 'pending',
        'limit' => -1,
        'return' => 'ids',
    ) );

    foreach ( $pending_orders as $order_id ) {
        $order = wc_get_order( $order_id );
        foreach ( $order->get_items() as $item ) {
            if ( $item->get_product_id() === $product_id ) {
                $pending_qty += $item->get_quantity();
            }
        }
    }
    return $pending_qty;
}

// 修改商品页面的库存显示内容
function adjust_displayed_stock_qty( $stock_html, $product ) {
    if ( ! $product->is_in_stock() || ! $product->managing_stock() ) {
        return $stock_html;
    }

    $total_stock = $product->get_stock_quantity();
    $pending_qty = get_pending_order_stock_qty( $product->get_id() );
    $available_stock = max( 0, $total_stock - $pending_qty );

    // 保持默认的库存显示格式
    $stock_html = sprintf(
        '<p class="stock%s">%s</p>',
        esc_attr( $product->get_stock_status() ),
        esc_html( sprintf( __( '%s in stock', 'woocommerce' ), $available_stock ) )
    );
    return $stock_html;
}
add_filter( 'woocommerce_get_stock_html', 'adjust_displayed_stock_qty', 10, 2 );

// 同步修改购物车/结算页的库存不足提示内容（可选）
function adjust_cart_stock_notice( $notice, $product_id, $quantity ) {
    $product = wc_get_product( $product_id );
    if ( ! $product || ! $product->managing_stock() ) {
        return $notice;
    }

    $total_stock = $product->get_stock_quantity();
    $pending_qty = get_pending_order_stock_qty( $product_id );
    $available_stock = max( 0, $total_stock - $pending_qty );

    if ( $quantity > $available_stock ) {
        $notice = sprintf(
            __( 'Sorry, we only have %1$s %2$s left in stock.', 'woocommerce' ),
            $available_stock,
            $product->get_name()
        );
    }
    return $notice;
}
add_filter( 'woocommerce_cart_item_added_notice', 'adjust_cart_stock_notice', 10, 3 );

方案1具体实现代码（可选） #

若坚持选择直接扣减库存的方案，可使用以下代码，同时需在WooCommerce后台设置「库存持有时间」（路径：WooCommerce > 设置 > 产品 > 库存），到期后待付款订单自动取消并回滚库存：

// 待付款订单创建时扣减库存
function reduce_stock_on_pending_order( $order_id ) {
    $order = wc_get_order( $order_id );
    if ( $order->get_status() !== 'pending' ) {
        return;
    }

    foreach ( $order->get_items() as $item ) {
        $product = $item->get_product();
        if ( $product && $product->managing_stock() ) {
            $current_stock = $product->get_stock_quantity();
            $product->set_stock_quantity( $current_stock - $item->get_quantity() );
            $product->save();
        }
    }
}
add_action( 'woocommerce_order_status_pending', 'reduce_stock_on_pending_order' );

// 订单取消/失败时回滚库存
function restore_stock_on_order_cancel( $order_id ) {
    $order = wc_get_order( $order_id );
    foreach ( $order->get_items() as $item ) {
        $product = $item->get_product();
        if ( $product && $product->managing_stock() ) {
            $current_stock = $product->get_stock_quantity();
            $product->set_stock_quantity( $current_stock + $item->get_quantity() );
            $product->save();
        }
    }
}
add_action( 'woocommerce_order_status_cancelled', 'restore_stock_on_order_cancel' );
add_action( 'woocommerce_order_status_failed', 'restore_stock_on_order_cancel' );

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