问题描述与技术背景
在开发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');
?>
