WordPress中functions.php无法实现页面地理定位重定向问题排查

问题核心 #

从调试日志可见，地理拦截函数已触发，但始终无法获取IP对应的国家信息，导致后续重定向逻辑完全无法执行。问题根源集中在IP获取逻辑不严谨和第三方API请求处理不完善两点。

修复步骤 #

1. 修正IP获取逻辑 #

HTTP_X_FORWARDED_FOR可能返回逗号分隔的多个IP（如代理链场景），直接取值会导致ipinfo.io无法识别，需提取第一个有效IP。

2. 完善API请求配置 #

给wp_remote_get添加超时设置避免请求卡住，同时改用HTTPS请求ipinfo.io，防止HTTP请求被服务器或浏览器拦截。

3. 增强数据校验 #

读取country字段前，先确认返回的geo_data是有效数组，避免因API返回异常导致报错。

4. 修正URL路径匹配 #

parse_url返回的路径会带开头斜杠（如/an-url-I-want-to-geo-block），需确保restricted_url_path格式与实际路径一致。

完整修正代码 #

function redirect_belgian_users() {
    // 检测是否能获取到IP
    if (!isset($_SERVER["REMOTE_ADDR"])) {
        error_log("Geo-block: 未检测到IP地址");
        return;
    }

    // 正确获取用户真实IP（处理代理场景）
    $user_ip = $_SERVER["REMOTE_ADDR"];
    if (!empty($_SERVER["HTTP_X_FORWARDED_FOR"])) {
        // 提取第一个有效IP
        $ip_list = explode(',', $_SERVER["HTTP_X_FORWARDED_FOR"]);
        $user_ip = trim(reset($ip_list));
    }
    error_log("Geo-block function triggered for IP: " . $user_ip);

    // 调用ipinfo.io API（改用HTTPS并设置超时）
    $response = wp_remote_get("https://ipinfo.io/{$user_ip}/json", [
        'timeout' => 5, // 设置5秒超时
        'sslverify' => true // 验证SSL证书
    ]);

    if (is_wp_error($response)) {
        error_log("Geo-block API错误: " . $response->get_error_message());
        return;
    }

    $response_body = wp_remote_retrieve_body($response);
    $geo_data = json_decode($response_body, true);

    // 增强数据校验
    if (!is_array($geo_data) || empty($geo_data["country"])) {
        error_log("Geo-block: 未获取到国家信息，API返回内容: " . $response_body);
        return;
    }

    error_log("Geo-block: IP {$user_ip} 所属国家: {$geo_data["country"]}");

    // 非比利时用户直接返回
    if ($geo_data["country"] !== "BE") {
        error_log("Geo-block: 非比利时访客，无需处理");
        return;
    }

    // 检查当前页面路径（注意斜杠匹配）
    $current_url_path = parse_url($_SERVER["REQUEST_URI"], PHP_URL_PATH);
    $restricted_url_path = "/an-url-I-want-to-geo-block"; // 确保开头带斜杠

    error_log("当前页面路径: {$current_url_path}");
    
    if ($current_url_path !== $restricted_url_path) {
        error_log("Geo-block: 用户不在拦截页面，无需重定向");
        return;
    }

    // 执行重定向
    error_log("Geo-block: 重定向比利时访客从 {$current_url_path} 到首页");
    wp_safe_redirect(home_url());
    exit;
}
add_action("template_redirect", "redirect_belgian_users");

额外注意事项 #

• API请求限制：ipinfo.io免费版每月有5万次请求限制，高流量网站建议使用付费版或本地IP地理数据库（如MaxMind GeoIP2）。
• 缓存优化：可将IP对应的国家信息缓存到WordPress transient中，避免重复调用API，提升性能。
• 测试方法：可临时将$user_ip硬编码为比利时IP（如217.113.194.181），测试重定向逻辑是否生效。

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