WooCommerce基于商品属性与用户角色的购物车折扣不生效问题排查

我正在开发搭载WooCommerce的WordPress站点，需实现特定购物车折扣功能：仅为distributor和dr52角色用户，针对带自定义尺寸属性（如'S (23 x 15 CM)'等）的商品，按符合条件商品总数量应用不同折扣价。

我编写了相关代码（如下），经调试，总数量计算与折扣区间逻辑正常，但购物车商品价格未按预期更新。测试发现用简单函数设固定价格可生效，说明环境支持修改购物车价格。

已尝试的解决措施：

• 核查折扣逻辑与属性验证逻辑
• 更换WooCommerce钩子（woocommerce_before_calculate_totals、woocommerce_cart_calculate_fees）
• 简化逻辑测试以排除插件/主题冲突

请问：

1. 当前实现是否存在遗漏点导致价格不更新？
2. 修改WooCommerce购物车价格有哪些已知交互限制？

代码实现 #

$size_based_discounts = [
    'S (23 x 15 CM)' => [7.80, 7.02, 6.38, 5.85],
    'M (50 x 15 CM)' => [10.10, 9.09, 8.26, 7.57],
    'L (28 x 26 CM)' => [11.01, 9.91, 9.01, 8.26],
    'Baby (25 x 12 CM)' => [7.80, 7.02, 6.38, 5.85]
];

function is_distributor_or_dr52() {
    $user = wp_get_current_user();
    return in_array('distributor', $user->roles) || in_array('dr52', $user->roles);
}

function count_products_by_size_in_cart($size_based_discounts) {
    $total_quantity = 0;
    foreach ( WC()->cart->get_cart() as $cart_item ) {
        if ( ! isset( $cart_item['data'] ) ) {
            continue;
        }
        $product = $cart_item['data'];
        $size = $product->get_attribute('pa_tamano');
        if ( array_key_exists( $size, $size_based_discounts ) ) {
            $total_quantity += $cart_item['quantity'];
        }
    }
    return $total_quantity;
}

function apply_discount_by_quantity($cart) {
    if ( ! is_distributor_or_dr52() ) {
        return;
    }

    global $size_based_discounts;
    $total_quantity = count_products_by_size_in_cart($size_based_discounts);

    $discount_range = 0;
    if ( $total_quantity > 49 ) {
        $discount_range = 3;
    } elseif ( $total_quantity > 27 ) {
        $discount_range = 2;
    } elseif ( $total_quantity > 13 ) {
        $discount_range = 1;
    }

    foreach ( $cart->get_cart() as $cart_item_key => $cart_item ) {
        $product = $cart_item['data'];
        if ( $product->is_type( 'variable' ) ) {
            $size = $product->get_attribute('pa_tamano');
            if ( array_key_exists( $size, $size_based_discounts ) ) {
                $discounted_price = $size_based_discounts[$size][$discount_range];
                $cart_item['data']->set_price( $discounted_price );
            }
        }
    }
}
add_action( 'woocommerce_before_calculate_totals', 'apply_discount_by_quantity', 10, 1 );

function show_original_price_struck_in_cart($price, $cart_item, $cart_item_key) {
    if ( ! is_distributor_or_dr52() ) {
        return $price;
    }

    if ( isset( $cart_item['original_price'] ) ) {
        $original_price = $cart_item['original_price'];
        $discounted_price = $cart_item['data']->get_price();
        if ( $original_price > $discounted_price ) {
            return '<del>' . wc_price( $original_price ) . '</del> ' . wc_price( $discounted_price );
        }
    }
    return $price;
}
add_filter( 'woocommerce_cart_item_price', 'show_original_price_struck_in_cart', 10, 3 );

1. 当前实现的遗漏点分析 #

你的代码存在几个关键问题，直接导致价格不更新：

• 商品类型判断错误：购物车中的变量商品实际是变体（variation），类型为variation而非variable（variable是父商品，不会出现在购物车），你的判断条件过滤掉了所有符合要求的商品。
• 未保存原价：show_original_price_struck_in_cart函数依赖$cart_item['original_price']，但代码中从未设置该值，导致原价划掉逻辑无法生效。
• 全局变量风险：使用global $size_based_discounts可能被其他代码修改，导致逻辑异常，建议直接在函数内定义或通过参数传递。
• 钩子优先级不足：woocommerce_before_calculate_totals优先级设为10，可能被其他插件/主题的同钩子函数覆盖，建议提高到20确保逻辑最后执行。

核心修正示例 #

foreach ( $cart->get_cart() as $cart_item_key => $cart_item ) {
    $product = $cart_item['data'];
    // 改为判断变体类型
    if ( $product->is_type( 'variation' ) ) {
        $size = $product->get_attribute('pa_tamano');
        if ( array_key_exists( $size, $size_based_discounts ) ) {
            // 保存原价到购物车项，用于显示划掉价
            if ( !isset($cart_item['original_price']) ) {
                $cart_item['original_price'] = $product->get_regular_price();
            }
            $discounted_price = $size_based_discounts[$size][$discount_range];
            $product->set_price( $discounted_price );
        }
    }
}

2. 修改WooCommerce购物车价格的已知限制 #

• 商品类型差异：不同商品类型（简单商品、变体、订阅商品）的价格修改逻辑不同，比如变体必须操作variation对象，订阅商品需额外处理周期价格。
• 钩子触发特性：woocommerce_before_calculate_totals会被多次触发（添加商品、更新数量、切换地址等），需确保逻辑幂等，避免重复修改价格。
• 缓存与会话冲突：WooCommerce会缓存购物车数据，修改价格后需确保触发刷新，否则可能显示旧价格；注意不要在钩子内递归调用$cart->calculate_totals()。
• 第三方插件干扰：折扣、定价类插件也会使用相同钩子，若优先级低于你的函数会覆盖设置，反之则你的设置会被覆盖。
• 系统价格验证：WooCommerce内置成本价验证，若折扣价低于商品成本，可能被系统拦截。
• 关联计算影响：修改商品价格后，税费、运费会重新计算，若运费/税费基于原价规则，可能出现计算异常，需同步验证。

内容的提问来源于stack exchange，提问作者Jose Ant Navalón