基于WooCommerce购物车小计阈值自动应用优惠券故障求助

原代码存在的问题 #

1. 钩子选择错误：woocommerce_checkout_before_order_review仅在结账页面首次加载时触发，购物车内容更新（增减商品、修改数量）时不会同步触发，导致优惠券无法实时更新，出现不稳定情况。
2. 通知被强制清除：代码末尾调用wc_clear_notices()，直接清空了之前输出的折扣提示，用户无法看到优惠券应用的反馈。
3. 条件逻辑不匹配：原代码elseif ( $cart_total > 100 )会包含200英镑及以上的金额，与你设置的black10优惠券（仅适用于100-199.99英镑）规则冲突，导致逻辑错误。
4. 未做状态校验：反复调用apply_coupon和remove_coupon，未检查优惠券是否已应用或存在，可能触发重复应用错误或无效操作。
5. 缺少安全校验：未判断WC()->cart对象是否存在，极端场景下可能引发致命错误。

修复后的代码 #

add_action( 'woocommerce_before_calculate_totals', 'auto_apply_discount_coupons', 20 );
function auto_apply_discount_coupons() {
    // 安全校验：确保购物车对象存在且非空
    if ( ! WC()->cart || WC()->cart->is_empty() ) {
        return;
    }

    // 获取购物车商品小计（不含运费和税，若需基于订单总额请改用 get_cart_total()）
    $cart_total = WC()->cart->get_subtotal();
    // 获取当前已应用的优惠券列表
    $applied_coupons = WC()->cart->get_applied_coupons();

    // 清除旧通知，避免重复提示
    wc_clear_notices();

    // 根据金额区间处理优惠券
    if ( $cart_total > 200 ) {
        // 移除不符合条件的black10
        if ( in_array( 'black10', $applied_coupons ) ) {
            WC()->cart->remove_coupon( 'black10' );
        }
        // 未应用black20则添加
        if ( ! in_array( 'black20', $applied_coupons ) ) {
            if ( WC()->cart->apply_coupon( 'black20' ) ) {
                wc_print_notice( '20% off £200 or more - Discount Applied!', 'notice' );
            }
        }
    } elseif ( $cart_total > 100 && $cart_total <= 199.99 ) {
        // 移除不符合条件的black20
        if ( in_array( 'black20', $applied_coupons ) ) {
            WC()->cart->remove_coupon( 'black20' );
        }
        // 未应用black10则添加
        if ( ! in_array( 'black10', $applied_coupons ) ) {
            if ( WC()->cart->apply_coupon( 'black10' ) ) {
                wc_print_notice( '10% off £100 or more - Discount Applied!', 'notice' );
            }
        }
    } else {
        // 金额不满足条件时，移除所有相关优惠券
        if ( in_array( 'black10', $applied_coupons ) ) {
            WC()->cart->remove_coupon( 'black10' );
        }
        if ( in_array( 'black20', $applied_coupons ) ) {
            WC()->cart->remove_coupon( 'black20' );
        }
    }
}

修复说明 #

• 更换触发钩子：使用woocommerce_before_calculate_totals，该钩子在购物车总价计算前触发，涵盖购物车页面和结账页面的所有更新操作，确保优惠券实时同步生效。
• 精准匹配规则：修正black10的触发条件为$cart_total > 100 && $cart_total <= 199.99，完全贴合你设置的优惠券使用范围。
• 添加状态校验：先检查优惠券是否已应用，避免重复添加/移除操作，减少错误触发概率。
• 保留用户反馈：移除末尾的强制清除通知代码，确保用户能看到优惠券应用的提示信息。
• 边界场景处理：新增金额不满足条件的分支，自动移除已应用的优惠券，避免无效折扣残留。

内容的提问来源于stack exchange，提问作者Phi Cao