WooCommerce购物车特定商品排除折扣功能故障排查

核心问题分析 #

你的修改代码存在两个致命逻辑错误：

1. 函数定义位置错误：你把wpf_wc_add_cart_fees_by_cart_qty函数定义放在了else条件块里，这会导致函数只有在购物车没有ID为12345的商品时才会被定义。但add_action是在脚本加载阶段就执行的，当WooCommerce触发woocommerce_cart_calculate_fees钩子时，如果函数未被定义，整个折扣逻辑直接失效。
2. 过早调用购物车对象：在脚本加载阶段（全局环境）调用WC()->cart，此时购物车对象可能还未初始化，会导致商品检测逻辑返回错误结果，甚至抛出PHP错误。

修复后的代码 #

把商品检测逻辑移到函数内部，利用钩子传递的$cart参数来操作，避免全局环境的时序问题：

add_action( 'woocommerce_cart_calculate_fees', 'wpf_wc_add_cart_fees_by_cart_qty' );
if ( ! function_exists( 'wpf_wc_add_cart_fees_by_cart_qty' ) ) {
    /**
     * 添加多人购买折扣（排除特定商品）
     */
    function wpf_wc_add_cart_fees_by_cart_qty( $cart ) {
        // 检测购物车中是否存在ID为12345的商品
        $target_product_id = 12345;
        $has_target_product = false;
        
        foreach ( $cart->get_cart() as $cart_item ) {
            if ( $cart_item['product_id'] == $target_product_id ) {
                $has_target_product = true;
                break;
            }
        }
        
        // 如果存在目标商品，直接返回不执行折扣
        if ( $has_target_product ) {
            return;
        }
        
        // 原有的折扣逻辑
        $qty = $cart->get_cart_contents_count();
        if ( $qty > 1 ) {
            $name      = 'Korting meerdere deelnemers';
            $amount    = -10;
            $taxable   = true;
            $tax_class = '';
            $cart->add_fee( $name, $amount, $taxable, $tax_class );
        }
    }
}

额外说明 #

• 使用$cart->get_cart()遍历购物车商品，比generate_cart_id+find_product_in_cart更直接可靠，还能处理变体商品（如果需要检测变体ID，可改用$cart_item['variation_id']）。
• 函数定义始终在全局环境中完成，确保钩子触发时能找到对应的回调函数，逻辑判断全部放在函数内部，保证每次购物车更新时都会重新检测商品状态。

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