Viber iOS端含西里尔符号URL双重编码致404问题求助

问题背景 #

• 用户反馈：iOS端Viber打开我方分享的含西里尔符号链接时，会跳转到404页面
• 核心原因：仅iOS端Viber会对URL做双重编码——原链接example.com/%D0%BA%D0%BE%D0%BD%D1%82%D0%B0%D0%BA%D1%82%D0%B8/被处理为example.com/%25D0%25BA%25D0%25BE%25D0%25BD%25D1%2582%25D0%25B0%25D0%25BA%25D1%2582%25D0%25B8/（西里尔字符的URL编码前多了%25，也就是%的编码值）
• 对比验证：WhatsApp、Messenger及安卓/桌面端Viber均无此问题，URL元数据在iOS端可正常传递

临时方案分析 #

你当前在WooCommerce的functions.php中添加的代码能解决问题，但存在几个可优化的细节：

add_action('init', 'normalize_request_uri_for_ios');

function normalize_request_uri_for_ios() {
    // Check if the user is on an iOS device
    if (wp_is_mobile() && strpos($_SERVER['HTTP_USER_AGENT'], 'iPhone') !== false || strpos($_SERVER['HTTP_USER_AGENT'], 'iPad') !== false) {
        // Decode the current URL
        $decoded_uri = urldecode($_SERVER['REQUEST_URI']);

        // Check if the URI contains the query parameter `redirected=1` to prevent loops
        if ($_SERVER['REQUEST_URI'] !== $decoded_uri && strpos($decoded_uri, '%') === false && !isset($_GET['redirected'])) {
            // Append the `redirected=1` parameter to prevent further redirection
            $new_uri = add_query_arg('redirected', '1', $decoded_uri);
            wp_safe_redirect($new_uri, 301);
            exit;
        }
    }
}

现有方案的不足 #

1. 设备判断冗余：wp_is_mobile()已经包含iOS设备识别，再叠加iPhone/iPad的UA检查属于重复操作，还可能遗漏iOS 13+部分iPad（这类设备UA不再包含iPad关键词）
2. 重定向状态码错误：301是永久重定向，会被浏览器缓存，若后续Viber修复该BUG，用户仍会被旧缓存的重定向规则影响，应该用302临时重定向
3. 循环防护不严谨：仅靠redirected=1参数判断，用户手动移除该参数后可能触发重复重定向
4. 解码逻辑覆盖不全：假设解码一次就无%符号，但极端场景可能存在多重编码，应该循环解码直到无编码字符，或限制解码次数避免异常

优化后的解决方案 #

add_action('init', 'fix_viber_ios_double_encoding');

function fix_viber_ios_double_encoding() {
    // 只针对iOS端Viber处理
    $user_agent = $_SERVER['HTTP_USER_AGENT'] ?? '';
    if (!str_contains($user_agent, 'iOS') || !str_contains($user_agent, 'Viber')) {
        return;
    }

    $request_uri = $_SERVER['REQUEST_URI'] ?? '';
    $decoded_uri = $request_uri;
    $decode_count = 0;
    $max_decodes = 3; // 限制最大解码次数，防止无限循环

    // 循环解码直到无编码字符或达到最大次数
    while (strpos($decoded_uri, '%') !== false && $decode_count < $max_decodes) {
        $new_decoded = urldecode($decoded_uri);
        if ($new_decoded === $decoded_uri) {
            break; // 无法继续解码，退出循环
        }
        $decoded_uri = $new_decoded;
        $decode_count++;
    }

    // 仅当解码后URI和原URI不同，且未触发过修复跳转时执行重定向
    if ($decoded_uri !== $request_uri && !isset($_GET['viber_fixed'])) {
        $new_uri = add_query_arg('viber_fixed', '1', $decoded_uri);
        wp_safe_redirect($new_uri, 302); // 使用临时重定向
        exit;
    }
}

优化点说明 #

• 精准UA判断：直接检查UA是否同时包含iOS和Viber，避免误判其他iOS应用或浏览器
• 循环解码逻辑：支持处理多重编码场景，同时限制最大解码次数防止无限循环
• 临时重定向：用302状态码，避免浏览器永久缓存重定向规则
• 清晰的循环防护：用viber_fixed=1明确标识已处理的请求，减少歧义

最佳实践建议 #

1. 优先推动客户端修复：这个问题本质是iOS端Viber的BUG，建议向Viber官方反馈URL编码异常问题，从根源解决
2. 选择更精准的钩子：当前用init钩子处理全局请求，后续WordPress或WooCommerce路由逻辑变更可能引发冲突，可考虑用parse_request钩子更精准处理路由解析
3. 添加日志监控：在代码里加error_log()记录触发次数，便于后续评估修复效果或调整方案
4. 测试边缘场景：测试混合字符（西里尔+英文+特殊字符）的链接，确保解码逻辑不会破坏正常URL

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