Android WebView 主备URL自动切换方法

本文介绍如何通过 WebViewClient 拦截网络错误，在主域名不可访问时自动切换至备用域名，适用于因地区网络策略导致的合法网站访问受限场景。

本文介绍如何通过 WebViewClient 拦截网络错误，在主域名不可访问时自动切换至备用域名，适用于因地区网络策略导致的合法网站访问受限场景。

在开发面向多地区的 Android Web App 时，常遇到部分国家/地区对特定合法域名（如新闻媒体、文化类网站）实施非恶意但事实存在的网络访问限制。此时若仅加载单一 URL（如 https://domainone.com），WebView 将直接报错（如 net::ERR_CONNECTION_REFUSED、net::ERR_HOST_LOOKUP 或 net::ERR_CONNECTION_RESET），导致白屏或崩溃体验。为提升鲁棒性与可用性，推荐采用“主备 URL 故障转移”策略：优先尝试主站，连接失败后无缝降级至已备案或镜像的备用站点（如 https://domaintwo.com）。

实现该逻辑的核心在于重写 WebViewClient.shouldInterceptRequest() 或更常用且精准的 onReceivedError() 回调。注意：shouldInterceptRequest() 不适用于初始页面加载的错误拦截，而 onReceivedError() 可捕获 WebView 加载过程中的关键网络错误，是本方案的首选。

以下为完整、安全、可直接集成的 Java 实现：

webView.setWebViewClient(new WebViewClient() {
    @Override
    public void onReceivedError(WebView view, WebResourceRequest request, WebResourceError error) {
        super.onReceivedError(view, request, error);

        // 获取错误码（Android 8.0+ 推荐使用 error.getErrorCode()）
        int errorCode = error.getErrorCode();

        // 关键判断：仅当发生明确的网络连接或 DNS 解析失败时，才切换至备用 URL
        // ERROR_HOST_LOOKUP（-2）：DNS 查询失败（域名无法解析）
        // ERROR_CONNECT（-6）：TCP 连接被拒绝或超时（常见于防火墙拦截）
        // 其他错误（如证书问题、重定向循环等）通常不建议盲目降级，应保持原错误行为
        if (errorCode == WebViewClient.ERROR_HOST_LOOKUP ||
            errorCode == WebViewClient.ERROR_CONNECT) {
            // 切换至备用 URL，并清除可能残留的加载状态
            webView.stopLoading();
            webView.loadUrl("https://domaintwo.com"); // 替换为你的备用域名
        } else {
            // 非连接类错误（如 404、SSL 错误等），保留默认错误页或自定义提示
            Log.w("WebView", "Non-fatal error: " + errorCode + ", keeping current page.");
        }
    }

    @Override
    public void onPageFinished(WebView view, String url) {
        super.onPageFinished(view, url);
        // 可选：记录成功加载的 URL，用于调试或埋点
        Log.d("WebView", "Page loaded successfully: " + url);
    }
});

⚠️ 重要注意事项：

• URL 协议修正：原始问题中 htttps:// 为拼写错误，务必使用标准 https://（双 s），否则 WebView 会直接抛出 net::ERR_INVALID_URL；
• 错误码范围：ERROR_HOST_LOOKUP（-2）、ERROR_CONNECT（-6）是判断“网络不可达”的最可靠指标；避免将 ERROR_TIMEOUT（-5）或 ERROR_UNKNOWN（-1）等泛化错误纳入降级条件，以防掩盖真实问题；
• 首次加载逻辑：上述代码处理的是加载失败后的自动降级。若需在启动时主动探测连通性（例如预检主站是否可达），需额外结合 ConnectivityManager 或 OkHttp 异步 Ping，但会增加首屏延迟和权限依赖，一般不推荐；
• HTTPS 安全要求：确保两个域名均配置有效 TLS 证书，否则 WebView 在 Android 7.0+ 默认禁止混合内容，且 onReceivedHttpError() 不会触发（仅 onReceivedError() 处理网络层错误）；
• 用户体验优化：可在降级前显示轻量级加载提示（如 ProgressBar），并在 onPageStarted() 中隐藏，避免用户感知“闪退—重载”过程。

综上，该方案以最小侵入性、最高兼容性实现了地理网络限制下的优雅降级，既保障了服务连续性，又符合 Android 最佳实践。只需将 https://domainone.com 和 https://domaintwo.com 替换为实际域名，即可在各类受限网络环境中稳定运行。