WooCommerce按购物车小计切换税率代码失效问题排查

• 钩子类型和挂载范围错误：woocommerce_product_variation_get_tax_class是过滤器（filter）钩子，原代码用add_action挂载本身就不符合WooCommerce钩子规范；且该钩子仅作用于可变商品的变体，普通简单商品、其他商品类型不会触发该逻辑，导致部分商品税类不随规则切换。
• 税类标识传值错误：代码中传入的Standard、Reduced rate是税类的后台展示名称，WooCommerce实际识别的是税类slug，对应两个税类的正确标识为standard、reduced-rate，传错值会导致系统找不到对应税类，自动fallback到默认税类配置。
• 小计计算逻辑错误：原代码手动遍历购物车取edit上下文价格计算小计，取到的是商品后台原始定价，没有叠加商品折扣、价格调整规则，且没有做非空判断，当购物车未初始化、页面不在购物车/结账流程中时，直接遍历购物车会触发PHP致命错误；同时手动计算的时机早于WooCommerce购物车金额计算流程，拿到的商品数量、价格数据可能不完整。
• 缺少递归防护：税类获取逻辑本身是购物车金额计算的一环，在这个逻辑中直接触发购物车金额计算会造成无限递归，导致页面卡死、内存溢出。

// 同时覆盖简单商品、可变商品变体的税类获取逻辑
add_filter( 'woocommerce_product_get_tax_class', 'wp_auto_switch_tax_rate_by_subtotal', 10, 2 );
add_filter( 'woocommerce_product_variation_get_tax_class', 'wp_auto_switch_tax_rate_by_subtotal', 10, 2 );
function wp_auto_switch_tax_rate_by_subtotal( $tax_class, $product ) {
    // 静态标记防止递归计算
    static $is_running = false;
    if ( $is_running ) {
        return $tax_class;
    }

    // 后台页面、购物车对象未初始化时直接返回原税类，避免报错
    if ( is_admin() || ! WC()->cart instanceof WC_Cart ) {
        return $tax_class;
    }

    $is_running = true;
    // 调用WooCommerce原生方法取购物车商品小计（不含税，为商品原价合计未扣商品折扣）
    // 如需按扣除商品折扣后的金额判断，替换为 WC()->cart->get_cart_contents_total()
    $cart_subtotal = WC()->cart->get_subtotal();
    $is_running = false;

    // 按规则返回对应税类的系统slug
    return $cart_subtotal >= 1000 ? 'standard' : 'reduced-rate';
}

使用说明：代码放入当前主题的functions.php文件或者自定义功能插件中即可生效，税类判断阈值如果需要调整，直接修改判断条件里的1000数值即可。

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