WooCommerce 订阅商品单订单限购逻辑异常问题技术咨询

问题根因 #

原有代码仅在「用户当前添加的是订阅商品」时才触发校验逻辑，完全没有覆盖「用户先添加订阅商品到购物车、后续添加非订阅商品」的校验场景，因此出现两类商品同时存在的异常。

修复后完整代码 #

// 订阅商品ID配置，后续调整仅需修改此处
define( 'CUSTOM_SUBSCRIPTION_PRODUCT_IDS', array( 245632, 245626, 245623, 245620, 245617, 245614, 245610, 245606, 245601 ) );

// 购物车加购校验：订阅商品与非订阅商品不可同时存在
add_filter( 'woocommerce_add_to_cart_validation', 'wc_limit_subscription_cart_mixed', 10, 2 );
function wc_limit_subscription_cart_mixed( $passed_validation, $product_id ) {
    $cart = WC()->cart;
    // 先判断购物车中是否已经存在订阅商品
    $has_subscription_in_cart = false;
    foreach ( $cart->get_cart() as $cart_item ) {
        if ( in_array( $cart_item['product_id'], CUSTOM_SUBSCRIPTION_PRODUCT_IDS ) ) {
            $has_subscription_in_cart = true;
            break;
        }
    }

    // 场景1：购物车已有订阅商品，当前添加的是非订阅商品，拦截
    if ( $has_subscription_in_cart && ! in_array( $product_id, CUSTOM_SUBSCRIPTION_PRODUCT_IDS ) ) {
        wc_add_notice( __( '订阅商品不可与其他非订阅商品同时购买，请先清空购物车后再添加新商品。', 'woocommerce' ), 'error' );
        return false;
    }

    // 场景2：当前添加的是订阅商品，购物车已有其他商品，拦截
    if ( in_array( $product_id, CUSTOM_SUBSCRIPTION_PRODUCT_IDS ) && $cart->get_cart_contents_count() >= 1 ) {
        wc_add_notice( __( '订阅商品不可与其他非订阅商品同时购买，请先清空购物车后再添加订阅商品。', 'woocommerce' ), 'error' );
        return false;
    }

    return $passed_validation;
}

逻辑说明 #

• 将订阅商品ID统一定义为常量，后续修改ID无需调整业务逻辑，维护成本更低
• 新增购物车已有订阅商品的判断，完整覆盖「先加订阅、后加普通商品」的场景
• 保留原有「先加普通、后加订阅」的校验逻辑，符合原有预期
• 两类场景的提示文案做了区分，用户更容易理解操作要求

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