启用AJAX Add to cart时WooCommerce无法切换订阅方案

WooCommerce Subscriptions 对订阅方案切换（subscription switch）场景的加购逻辑做了专属强校验：只有携带合法切换标识参数、走官方订阅切换专属请求链路的加购请求才会被放行。普通AJAX加购请求（包括侧边购物车插件发起的、WooCommerce核心默认触发的AJAX加购）因为缺失订阅切换必需的上下文参数，会直接被系统判定为「不可购买」状态拦截，和你查到的成因描述完全匹配。

方案1：补全AJAX加购的订阅切换参数（推荐，不影响现有AJAX交互体验） #

不需要禁用AJAX加购，只需要在用户处于订阅方案切换场景时，给加购请求自动补全Subscriptions要求的校验参数即可，把下面的代码加到当前主题的functions.php文件中：

/**
 * 修复订阅切换场景下AJAX加购被拦截的问题
 */
add_filter( 'woocommerce_loop_add_to_cart_args', 'fix_sub_switch_ajax_add_to_cart_args', 10, 2 );
add_filter( 'woocommerce_subscription_switch_add_to_cart_args', 'fix_sub_switch_ajax_add_to_cart_args', 10, 2 );
function fix_sub_switch_ajax_add_to_cart_args( $args, $product ) {
    // 仅在订阅切换场景下补全参数
    if ( isset( $_GET['switch-subscription'] ) && isset( $_GET['item'] ) ) {
        $args['attributes']['data-custom_data'] = json_encode( [
            'subscription_id' => absint( $_GET['switch-subscription'] ),
            'item_id'         => absint( $_GET['item'] ),
            'switch_nonce'    => wp_create_nonce( 'switch_subscription' )
        ] );
    }
    return $args;
}

add_action( 'wp_ajax_woocommerce_add_to_cart', 'capture_sub_switch_custom_data', 1 );
add_action( 'wp_ajax_nopriv_woocommerce_add_to_cart', 'capture_sub_switch_custom_data', 1 );
function capture_sub_switch_custom_data() {
    if ( isset( $_POST['custom_data'] ) ) {
        $custom_data = json_decode( stripslashes( $_POST['custom_data'] ), true );
        if ( ! empty( $custom_data['subscription_id'] ) && ! empty( $custom_data['item_id'] ) ) {
            $_POST['switch-subscription'] = $custom_data['subscription_id'];
            $_POST['item'] = $custom_data['item_id'];
            $_POST['_wpnonce'] = $custom_data['switch_nonce'];
        }
    }
}

加完代码后清空站点缓存、浏览器缓存再测试，订阅切换时的AJAX加购就会被Subscriptions正常识别，不会再被拦截。

方案2：针对订阅切换场景临时禁用AJAX加购（兜底方案） #

如果方案1和你用的侧边购物车插件有兼容问题，可以用这个兜底方案，代码同样加到主题functions.php：

/**
 * 订阅切换场景下禁用AJAX加购
 */
add_filter( 'woocommerce_product_supports', 'disable_ajax_on_sub_switch', 10, 3 );
function disable_ajax_on_sub_switch( $supports, $feature, $product ) {
    if ( 'ajax_add_to_cart' === $feature && isset( $_GET['switch-subscription'] ) ) {
        $supports = false;
    }
    return $supports;
}

这个方案生效后，用户在切换订阅方案时点击加购会走普通页面刷新的提交流程，完全绕开AJAX链路的校验问题，不会出现加购失败的情况，仅交互上没有AJAX顺滑。

• 加代码前建议先备份主题的functions.php文件，避免语法错误导致站点异常
• 如果用了缓存插件，一定要把订阅切换相关的页面加入缓存排除列表，避免参数丢失导致校验失败
• 测试时建议用无痕窗口验证，避免浏览器缓存旧的JS脚本影响效果

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