Woocommerce特定配送方式豁免VAT代码结算页加载失效问题

DevOps 小满

2026-10-5

问题根因

你当前使用的woocommerce_checkout_update_order_review钩子仅在结算页触发AJAX更新（比如用户手动切换配送方式、修改收货地址）时才会执行，结算页首次渲染加载阶段不会触发该钩子，因此VAT判断逻辑不会运行。

修复方案

需要新增覆盖首次加载场景的钩子，同时补充边界判断避免报错，修复后代码如下：

// 同时挂钩AJAX更新和首次加载场景
add_action( 'woocommerce_checkout_update_order_review', 'adjust_vat_for_local_pickup' );
add_action( 'woocommerce_before_calculate_totals', 'adjust_vat_for_local_pickup' );
  
function adjust_vat_for_local_pickup() {
    // 异常场景过滤，避免后台/未初始化状态报错
    if ( (is_admin() && ! defined( 'DOING_AJAX' )) || ! WC()->session || ! WC()->customer ) {
        return;
    }
    
    $chosen_methods = WC()->session->get( 'chosen_shipping_methods' );
    // 未选择配送方式时直接返回，避免数组下标越界
    if ( empty( $chosen_methods ) ) {
        return;
    }
    
    $chosen_shipping = $chosen_methods[0];
    if ( 0 === strpos( $chosen_shipping, 'local_pickup' ) ) {
        // 本地自提时取消VAT豁免
        WC()->customer->set_is_vat_exempt( false );
    } else {
        // 非自提场景复用你原有特定国家豁免VAT的逻辑即可，示例如下可自行替换
        $shipping_country = WC()->customer->get_shipping_country();
        $vat_exempt_countries = array( 'US', 'SG' ); // 替换为你实际需要豁免VAT的国家代码
        WC()->customer->set_is_vat_exempt( in_array( $shipping_country, $vat_exempt_countries ) );
    }
}