WooCommerce后台订单与用户自下单取消行为差异排查求助

问题场景 #

• 用户自下单流程：添加商品至购物车→选择PayPal支付→在PayPal页面取消并返回店铺，订单保留且购物车商品不丢失
• 后台创建订单流程：管理员通过wp-admin/post-new.php?post_type=shop_order创建订单→用户收到含支付链接的邮件→进入订单页选择PayPal支付→在PayPal点击“Cancel Order and return to shop”返回后，订单被取消且购物车被逐一清空

需要实现：后台创建的订单在支付取消时，保留购物车商品。

核心排查方向 #

1. 检查PayPal网关的取消回调逻辑 #

WooCommerce默认PayPal网关的核心代码位于wp-content/plugins/woocommerce/includes/gateways/paypal/class-wc-gateway-paypal.php，重点搜索以下内容：

• cancel_order方法：这是PayPal处理取消请求的核心函数
• woocommerce_paypal_cancel_order动作钩子：支付取消时会触发这个钩子，可能绑定了清空购物车的逻辑

2. 排查订单状态变更钩子 #

订单被取消时会触发woocommerce_order_status_cancelled等状态钩子，部分主题或自定义逻辑会在这些钩子下添加清空购物车的操作。检查以下位置：

• 当前主题的functions.php文件
• 自定义插件代码
• WooCommerce核心文件wp-content/plugins/woocommerce/includes/class-wc-order.php中状态变更相关的处理

3. 区分订单创建来源的特殊逻辑 #

后台创建的订单会带有_created_via元数据，值为admin，前台订单的值为checkout。部分逻辑会针对admin来源的订单做特殊处理，比如取消时强制清空购物车。可以在WooCommerce核心文件中搜索get_created_via()或_created_via，定位相关判断代码。

非侵入式修改方案（避免修改核心文件） #

不要直接修改WooCommerce核心代码（会被版本更新覆盖），建议通过钩子拦截实现需求：

方案1：拦截PayPal取消动作 #

add_action('woocommerce_paypal_cancel_order', 'prevent_cart_clear_for_admin_orders', 10, 1);
function prevent_cart_clear_for_admin_orders($order_id) {
    $order = wc_get_order($order_id);
    // 仅针对后台创建的订单生效
    if ($order && $order->get_created_via() === 'admin') {
        // 移除可能绑定的清空购物车动作（需替换为实际函数名）
        remove_action('woocommerce_paypal_cancel_order', 'wc_empty_cart_on_cancel', 10);
        // 保留订单状态（如果不需要取消订单，可添加以下代码）
        $order->update_status('pending', '用户取消支付，保留订单');
    }
}

方案2：拦截订单取消时的购物车清空 #

add_action('woocommerce_order_status_cancelled', 'block_cart_clear_on_admin_order_cancel', 5, 1);
function block_cart_clear_on_admin_order_cancel($order_id) {
    $order = wc_get_order($order_id);
    if ($order && $order->get_created_via() === 'admin') {
        // 阻止购物车清空操作
        remove_action('woocommerce_order_status_cancelled', 'custom_clear_cart_on_cancel', 10);
        // 可选：恢复购物车商品（如果已经被清空）
        $items = $order->get_items();
        foreach ($items as $item) {
            WC()->cart->add_to_cart($item->get_product_id(), $item->get_quantity());
        }
    }
}

将上述代码添加到当前主题的functions.php文件或自定义插件中即可生效。

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