WooCommerce结账异常排查与修复方法

在IT行业这个发展更新速度很快的行业，只有不停止的学习，才不会被行业所淘汰。如果你是文章学习者，那么本文《WooCommerce 结账表单异常排查与修复》就很适合你！本篇内容主要包括##content_title##，希望对大家的知识积累有所帮助，助力实战开发！

问题描述与技术背景

在开发WordPress网站上集成的WooCommerce自定义内页结账表单时，开发者可能会遇到一个独特的挑战：当用户在产品页面直接填写表单并尝试支付时，系统在预览模式下能正常处理订单，但在非预览模式下（例如在新的浏览器窗口或设备上访问）却会跳转到“购物车为空”页面，导致订单无法生成。

这种现象通常发生在自定义的结账流程中，尤其是当页面不完全遵循WooCommerce标准模板加载机制时。WooCommerce依赖于其内部会话（session）机制来维护用户的购物车状态。在标准的WooCommerce页面加载流程中，购物车会话数据通常会被自动初始化和加载。然而，在高度定制化的页面或插件中，如果缺少必要的初始化步骤，购物车对象可能无法正确地从用户会话中读取其当前状态，从而导致即使已经通过代码添加了商品，前端依然显示购物车为空。预览模式可能由于WordPress或WooCommerce的调试/开发环境配置，隐式地完成了部分会话初始化，从而掩盖了这一问题。

解决方案：强制加载购物车会话

解决此问题的关键在于确保在执行任何购物车操作（如清空购物车或添加商品）之前，WooCommerce的购物车对象已从当前用户会话中加载了最新的数据。WooCommerce提供了一个专门用于此目的的函数：wc_load_cart()。

wc_load_cart() 函数的作用是显式地加载并初始化WooCommerce的购物车会话数据。当在自定义代码中直接操作 WC()->cart 对象时，如果当前请求的会话尚未完全加载购物车信息，那么对购物车进行的任何操作都可能基于一个空或过时的状态。通过在操作前调用 wc_load_cart()，可以强制系统从会话中检索并填充购物车数据，确保后续操作的准确性。

实现步骤与示例代码

在您的自定义内页结账表单的PHP代码中，找到您执行购物车清空和添加商品操作的部分。通常，这会是类似 WC()->cart->empty_cart(); 和 WC()->cart->add_to_cart(...); 的代码行。

原始代码片段（可能存在问题）：

// ... 其他代码 ...

WC()->cart->empty_cart();
WC()->cart->add_to_cart($productId, 1, $initialVariation['id']);

// ... 其他代码 ...

修改后的代码片段（添加 wc_load_cart()）：

在 WC()->cart->empty_cart(); 之前，添加一行 wc_load_cart();。

get_available_variations();

$variations = array_map(function ($variation) use ($options) {
    return [
        'id' => $variation['variation_id'],
        'label' => $variation['attributes']['attribute_quantita'],
        'price' => $variation['display_price'],
        'regular_price' => $variation['display_regular_price'],
        'quantity' => strip_tags($variation['variation_description']),
        'highlight' => $options['highlight_label_' . $variation['variation_id']] ?? false,
        'highlight_color' => $options['highlight_label_color_' . $variation['variation_id']] ?? false,
    ];
}, $variations);

$initialVariation = $variations[0];

function formatPrice($price)
{
    echo number_format($price, 2, ',', '') . '€';
}

// 关键修复：在操作购物车前加载购物车会话
wc_load_cart(); 
WC()->cart->empty_cart();
WC()->cart->add_to_cart($productId, 1, $initialVariation['id']);

if(class_exists('WC_Gateway_Stripe')) {
    $stripe = new WC_Gateway_Stripe();

    $suffix = defined('SCRIPT_DEBUG') && SCRIPT_DEBUG ? '' : '.min';
    wp_register_style('stripe_styles', plugins_url('assets/css/stripe-styles.css', WC_STRIPE_MAIN_FILE), [], WC_STRIPE_VERSION);
    wp_enqueue_style('stripe_styles');

    wp_register_script('stripe', 'https://js.stripe.com/v3/', '', '3.0', true);
    wp_register_script('woocommerce_stripe', plugins_url('assets/js/stripe' . $suffix . '.js', WC_STRIPE_MAIN_FILE), ['jquery-payment', 'stripe'], WC_STRIPE_VERSION, true);
    wp_register_script('woocommerce_gateway_stripe', plugins_url('assets/js/stripe' . $suffix . '.js', WC_STRIPE_MAIN_FILE), ['jquery-payment', 'stripe'], WC_STRIPE_VERSION, true);

    wp_localize_script(
        'woocommerce_stripe',
        'wc_stripe_params',
        apply_filters('wc_stripe_params', $stripe->javascript_params())
    );

    $stripe->tokenization_script();
    wp_enqueue_script('woocommerce_stripe');
}


wp_enqueue_script('wc-country-select');
wp_enqueue_script('selectWoo');
wp_enqueue_style('select2');

$shippingMethods = WC()->shipping()->get_packages()[0]['rates'];
$chosenMethod = isset(WC()->session->chosen_shipping_methods[0]) ? WC()->session->chosen_shipping_methods[0] : '';

function business_day($days, $abbrv = false)
{
    if($abbrv) {
        return utf8_encode(strtolower(strftime('%a %e. %m.', strtotime(" $days weekdays"))));
    }
    return utf8_encode(strtolower(strftime('%A', strtotime(" $days weekdays"))));
}

function add_delivery_payment_info()
{
    printf('
');
    printf('
');
    printf('
');
    printf('
Oggi non paghi niente!
');
    printf('
Paghi alla consegna ?
');
    printf('
');
    printf('
    ');
    printf('
');
    printf('
');
}

add_action('woocommerce_review_order_before_submit', 'add_delivery_payment_info');

?>

    

        
Modulo d’ordine