WooCommerce基于用户元数据筛选支付网关异常求助

问题分析 #

你的自定义函数逻辑框架没问题，但普通用户仅能看到Stripe，大概率是细节处理疏漏导致，以下是具体排查方向和修复方案：

可能原因及解决方案 #

1. 用户元数据的网关ID错误或格式问题 #

WooCommerce内置网关的ID是固定值，务必匹配：

• Cash on Delivery: cod
• Direct Bank Transfer: bacs
• Stripe: stripe

排查与修复：

• 进入WordPress后台编辑目标用户，检查assigned_payment_gateways元字段的值，确保使用上述正确ID。
• 如果存储的是字符串格式（如cod,bacs），若存在空格（比如cod, bacs），会导致in_array匹配失败，需添加去空格处理：

if (is_string($user_gateways)) {
    // 去除每个网关ID的前后空格
    $user_gateways = array_map('trim', explode(',', $user_gateways));
}

2. 钩子优先级冲突 #

当前钩子优先级设为20，可能其他插件/主题的同类型过滤器先执行，已修改了可用网关列表（比如只剩Stripe）。

修复：
提高钩子优先级，确保你的函数最后执行：

add_filter('woocommerce_available_payment_gateways', 'filter_payment_gateways_based_on_user', 99);

3. 未登录用户逻辑处理 #

如果普通用户包含未登录状态，get_current_user_id()会返回0，此时user_gateways为空，你的函数会清空所有网关。但用户能看到Stripe，说明Stripe可能有独立逻辑强制显示，或用户是登录状态但元数据为空。

调整逻辑：
若希望未登录/元数据为空的用户能看到默认活跃网关，修改else分支：

} else {
    // 保留默认可用网关，而非清空
    // $available_gateways = [];
}

4. 调试验证 #

添加调试代码，确认函数拿到的网关列表和用户元数据是否匹配：

function filter_payment_gateways_based_on_user($available_gateways) {
    if (is_admin() && !defined('DOING_AJAX')) {
        return $available_gateways;
    }

    // 调试：记录可用网关ID
    error_log('Available gateways: ' . print_r(array_keys($available_gateways), true));

    $user_id = get_current_user_id();
    $user_gateways = get_user_meta($user_id, 'assigned_payment_gateways', true);

    // 调试：记录用户分配的网关
    error_log('User ID ' . $user_id . ' gateways: ' . print_r($user_gateways, true));

    if (!empty($user_gateways)) {
        if (is_string($user_gateways)) {
            $user_gateways = array_map('trim', explode(',', $user_gateways));
        }

        foreach ($available_gateways as $gateway_id => $gateway) {
            if (!in_array($gateway_id, $user_gateways)) {
                unset($available_gateways[$gateway_id]);
            }
        }
    } else {
        // 保留默认网关，根据需求调整
        // $available_gateways = [];
    }

    return $available_gateways;
}

打开WordPress根目录下的debug.log文件，确认：

• 可用网关列表是否包含cod、bacs等目标网关
• 用户元数据中的网关ID是否和可用网关ID完全一致

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