如何阻止woocommerce_available_payment_gateways钩子在结账页重复触发？

问题根源 #

woocommerce_available_payment_gateways 钩子在结账页面触发两次是正常现象：一次是页面首次加载时调用，另一次通常是AJAX请求（比如订单验证、购物车更新）时调用。两次请求的上下文不同，AJAX请求里大概率不会携带你代码中依赖的checkoutid GET参数，所以才会出现一次命中if分支、一次命中else分支的情况。

另外你的代码存在两个明显错误：

• 过滤器钩子不能用echo输出内容，这会破坏页面输出结构（尤其是AJAX请求的响应）；
• 过滤器里不能写exit，会直接中断WooCommerce的正常流程。

解决方案 #

方案1：仅在非AJAX的结账请求中处理逻辑

通过is_checkout()和wp_doing_ajax()区分请求类型，只在页面加载时应用网关修改逻辑：

function selected_custom_checkout_gateways( $available_gateways ) {
    // 仅在结账页面的非AJAX请求中执行修改
    if ( is_checkout() && ! wp_doing_ajax() && isset( $_GET['checkoutid'] ) && $_GET['checkoutid'] == '50' ) {
        unset( $available_gateways['cod'] );
        unset( $available_gateways['cheque'] );
    }
    return $available_gateways;
}
add_filter( 'woocommerce_available_payment_gateways', 'selected_custom_checkout_gateways' );

方案2：用会话存储checkoutid，保证两次请求判断一致

如果需要AJAX请求也应用相同的网关规则，可以把checkoutid存入会话，让两次请求都能读取到这个标识：

function selected_custom_checkout_gateways( $available_gateways ) {
    // 初始化会话
    if ( ! session_id() ) {
        session_start();
    }
    // 当GET参数存在时，写入会话（做安全过滤）
    if ( isset( $_GET['checkoutid'] ) ) {
        $_SESSION['checkoutid'] = sanitize_text_field( $_GET['checkoutid'] );
    }
    // 根据会话中的值判断是否修改网关
    if ( isset( $_SESSION['checkoutid'] ) && $_SESSION['checkoutid'] == '50' ) {
        unset( $available_gateways['cod'] );
        unset( $available_gateways['cheque'] );
    }
    return $available_gateways;
}
add_filter( 'woocommerce_available_payment_gateways', 'selected_custom_checkout_gateways' );

关键注意事项 #

1. 过滤器函数的核心职责是修改并返回$available_gateways数组，绝对不能在函数里输出内容或中断程序；
2. 避免依赖GET/POST参数做判断时，优先考虑会话（session）或WooCommerce的订单会话数据来存储临时标识；
3. 可以通过wp_doing_ajax()、is_checkout()等条件函数精准控制逻辑的执行时机。

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