WooCommerce 3.3.1自定义加入购物车URL重复添加商品问题求助

我来帮你排查这个重复添加商品的问题，在WooCommerce 3.3.1里用自定义加购URL确实容易踩这类小坑，咱们一步步拆解解决：

1. 先检查按钮的默认行为是否冲突 #

如果你的自定义按钮是放在WooCommerce默认的商品表单里，或者按钮类型是submit，那大概率是点击时同时触发了你的URL跳转和表单的默认提交动作，导致两次加购请求。

解决办法很简单：

• 把按钮类型改成button，避免触发表单提交：

  <button type="button" onclick="window.location.href='<?php echo esc_url($url); ?>'">直接去结账</button>
  

• 要是用<a>标签做按钮，要么别嵌套在商品表单里，要么用JS阻止默认行为：

  document.querySelector('.custom-checkout-btn').addEventListener('click', function(e) {
    e.preventDefault(); // 阻止默认的表单提交或链接跳转重复触发
    window.location.href = this.href;
  });
  

2. 确保URL参数准确且强制指定数量 #

你的URL里已经带了variation_id（这是WooCommerce识别变体的核心），但还是要确认参数有没有问题：

• 先打印生成的$url，检查variation_id和attribute_pa_starter-box的取值是否和当前变体完全匹配（属性slug是区分大小写的，别写错）。
• 手动加上quantity=1参数，强制每次只加1件，避免默认数量被重复叠加：

  $url = wc_get_checkout_url() . "/?add-to-cart=" . $loop->post->ID . "&variation_id=" . $variation['variation_id'] . "&attribute_pa_starter-box=" . $variation['attributes']['attribute_pa_starter-box'] . "&quantity=1";
  

3. 排查是否存在重复的事件绑定 #

如果你的按钮是动态生成的，或者用了jQuery的on()绑定点击事件，可能出现多次绑定的情况，导致点击一次触发多次跳转请求。

解决办法：绑定事件前先解绑原有事件：

$('.custom-checkout-btn').off('click').on('click', function(e) {
  e.preventDefault();
  window.location.href = this.href;
});

4. 用WooCommerce钩子强制拦截重复变体 #

如果以上方法都没解决，咱们直接从WooCommerce的加购逻辑入手，加个钩子拦截重复添加的变体：

add_filter('woocommerce_add_to_cart_validation', 'prevent_duplicate_variation_add_to_cart', 10, 3);
function prevent_duplicate_variation_add_to_cart($passed, $product_id, $quantity) {
    // 只处理变体商品的加购请求
    if (isset($_REQUEST['variation_id']) && $_REQUEST['variation_id'] > 0) {
        $target_variation_id = absint($_REQUEST['variation_id']);
        // 遍历购物车检查是否已存在该变体
        foreach (WC()->cart->get_cart() as $cart_item) {
            if ($cart_item['variation_id'] == $target_variation_id) {
                wc_add_notice(__('这个商品已经在你的购物车里啦', 'woocommerce'), 'notice');
                $passed = false; // 阻止重复添加
                break;
            }
        }
    }
    return $passed;
}

把这段代码加到你的主题functions.php文件或者自定义插件里，这样不管是什么原因触发的重复加购，都会被拦截并提示用户。

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