WooCommerce后台订单自定义扣减库存按钮问题排查

你的代码存在两个核心问题，导致误修改非目标商品库存：

1. 表单字段冲突：每个订单商品都会生成一个name="renew_order_single_product"的隐藏输入框，当订单包含多个商品时，表单提交后$_POST['renew_order_single_product']只会保留最后一个商品的ID——也就是说不管你点击哪个按钮，最终修改的都是订单里最后一个商品的库存。
2. 库存操作逻辑偏差：你直接将目标商品库存设置为0，而非根据订单内商品的实际数量扣减库存，既不符合常规业务逻辑，也容易引发不必要的库存清零问题。

add_action( 'woocommerce_after_order_itemmeta', 'action_woocommerce_order_item_add_button', 10, 2);
function action_woocommerce_order_item_add_button($item_id, $item)
{
    $product_id = $item->get_product_id();
    $item_quantity = $item->get_quantity(); // 获取当前订单商品的购买数量

    // 通过JS动态绑定目标商品信息，避免表单字段冲突
    echo '<button type="button" onclick="updateProductStock(' . $product_id . ', ' . $item_quantity . ')" class="button generate-items" style="background: red; color: white;">' . __( '扣减对应库存', 'hungred' ) . '</button>';
}

// 添加独立的库存更新表单，避免与订单编辑表单混淆
add_action('admin_footer', 'add_stock_update_form');
function add_stock_update_form() {
    global $post_type;
    if ( $post_type !== 'shop_order' ) return;
    ?>
    <form id="stock-update-form" method="post" style="display:none;">
        <?php wp_nonce_field('update_order_stock', 'stock_update_nonce'); ?>
        <input type="hidden" name="target_product_id" id="target_product_id">
        <input type="hidden" name="deduct_quantity" id="deduct_quantity">
        <input type="hidden" name="action" value="update_order_product_stock">
    </form>
    <script>
        function updateProductStock(productId, deductQty) {
            document.getElementById('target_product_id').value = productId;
            document.getElementById('deduct_quantity').value = deductQty;
            document.getElementById('stock-update-form').submit();
        }
    </script>
    <?php
}

// 用独立的后台动作处理库存更新，避免订单正常保存时误触发
add_action('admin_action_update_order_product_stock', 'handle_order_product_stock_update');
function handle_order_product_stock_update() {
    // 验证权限与安全令牌
    if (!current_user_can('edit_shop_orders') || !wp_verify_nonce($_POST['stock_update_nonce'], 'update_order_stock')) {
        wp_die('权限验证失败');
    }

    if (isset($_POST['target_product_id'], $_POST['deduct_quantity'])) {
        $product_id = absint($_POST['target_product_id']);
        $deduct_qty = absint($_POST['deduct_quantity']);
        
        $product = wc_get_product($product_id);
        if (!$product) return;

        // 按订单数量扣减库存，确保库存不低于0
        $current_stock = $product->get_stock_quantity();
        $new_stock = max(0, $current_stock - $deduct_qty);

        wc_update_product_stock($product, $new_stock);

        // 跳回原订单编辑页面
        wp_redirect(wp_get_referer());
        exit;
    }
}

• 解决字段冲突：通过独立表单+JavaScript动态赋值，确保每次提交的都是你点击的目标商品ID和对应购买数量。
• 避免误触发：用admin_action_*替代save_post钩子，彻底避免订单正常保存时意外触发库存更新。
• 符合业务逻辑：根据订单商品的实际购买数量扣减库存，同时限制库存最低为0，避免出现负数库存。

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