WooCommerce：修改订单项元数据致订单完成后购物车无法清空

问题描述 #

在使用WooCommerce时，我编写了自定义代码将购物车项的自定义数据转移至订单项，代码如下：

add_action('woocommerce_checkout_create_order_line_item', 'tls_checkout_create_order_line_item', 10, 4 );
function tls_checkout_create_order_line_item( $item, $cart_item_key, $values, $order ) {
    if (isset($values['custom_data']['tls_associated_line_item'])) {
        $item->update_meta_data('_tls_associated_order_item', $values['custom_data']['tls_associated_line_item']);
    }
    else{
        $item->update_meta_data('_tls_item_id', $cart_item_key);
    }
}

订单项已被正确更新，但该代码导致订单完成后购物车无法清空（推测可能是哈希值变化导致）。请问如何在不触发该问题的前提下更新订单项元数据？

问题原因 #

问题确实源于购物车项哈希值的意外变动。woocommerce_checkout_create_order_line_item钩子在订单创建流程中会被多次调用，在此阶段修改订单项元数据，会干扰WooCommerce对购物车项的哈希计算逻辑，导致系统判定购物车仍有未处理的变动，无法正常清空。

修复方案 #

改用专门处理订单项元数据的钩子，或在订单处理完成后再更新元数据，避免干扰购物车的哈希计算：

方案1：使用woocommerce_order_item_meta_save钩子 #

该钩子专门用于订单项元数据的保存操作，不会影响购物车的哈希计算：

add_action('woocommerce_order_item_meta_save', 'tls_save_order_item_meta', 10, 2);
function tls_save_order_item_meta($item_id, $item) {
    // 仅处理产品类型的订单项
    if ($item->get_type() !== 'line_item') return;
    
    $order = wc_get_order($item->get_order_id());
    $cart = WC()->cart;
    
    if (!$cart || !$order) return;
    
    // 匹配订单项对应的购物车项
    foreach ($cart->get_cart() as $cart_item_key => $values) {
        if ($item->get_product_id() === $values['data']->get_id() && $item->get_quantity() === $values['quantity']) {
            if (isset($values['custom_data']['tls_associated_line_item'])) {
                $item->update_meta_data('_tls_associated_order_item', $values['custom_data']['tls_associated_line_item']);
            } else {
                $item->update_meta_data('_tls_item_id', $cart_item_key);
            }
            $item->save();
            break;
        }
    }
}

方案2：使用woocommerce_checkout_order_processed钩子（订单完成后更新） #

等订单处理完成后再更新订单项元数据，此时购物车已进入清空流程，不会产生冲突：

add_action('woocommerce_checkout_order_processed', 'tls_update_order_items_after_checkout', 10, 3);
function tls_update_order_items_after_checkout($order_id, $posted_data, $order) {
    $cart = WC()->cart;
    if (!$cart) return;
    
    // 遍历订单订单项并匹配购物车数据
    foreach ($order->get_items() as $item_id => $item) {
        foreach ($cart->get_cart() as $cart_item_key => $values) {
            if ($item->get_product_id() === $values['data']->get_id() && $item->get_quantity() === $values['quantity']) {
                if (isset($values['custom_data']['tls_associated_line_item'])) {
                    $item->update_meta_data('_tls_associated_order_item', $values['custom_data']['tls_associated_line_item']);
                } else {
                    $item->update_meta_data('_tls_item_id', $cart_item_key);
                }
                $item->save();
                break;
            }
        }
    }
    
    // 手动触发购物车清空（可选，确保效果）
    $cart->empty_cart();
}

注意事项 #

• 必须移除原有的woocommerce_checkout_create_order_line_item钩子代码，防止冲突。
• 若购物车项包含变体或自定义属性，需在匹配订单项和购物车项时增加额外判断（比如变体ID），保证匹配的准确性。

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