WebView自定义错误页无法即时显示问题求助

这个问题我之前帮不少开发者解决过——核心问题在于WebView的原生错误页渲染逻辑是优先于我们的自定义回调的，所以会出现短暂的闪屏；而快速点击重试时，新请求的拦截没跟上，导致原生错误页又冒出来了。下面给你一套完整的解决方案：

1. 彻底拦截WebView的原生错误页渲染 #

WebView在触发错误回调时，其实已经开始准备渲染系统自带的错误页面了，所以我们要做的第一件事就是立刻终止当前加载，并强制加载自定义错误页，不给原生错误页任何显示的机会。

重写WebViewClient的关键方法，覆盖所有错误场景：

webView.setWebViewClient(new WebViewClient() {
    // 处理通用错误（如网络断开、页面不存在）
    @Override
    public void onReceivedError(WebView view, int errorCode, String description, String failingUrl) {
        // 终止当前加载，阻止原生错误页渲染
        view.stopLoading();
        // 加载本地自定义错误页
        view.loadUrl("file:///android_asset/error.html");
        super.onReceivedError(view, errorCode, description, failingUrl);
    }

    // 处理HTTP状态码错误（如404、500）
    @Override
    public void onReceivedHttpError(WebView view, WebResourceRequest request, WebResourceResponse errorResponse) {
        if (errorResponse.getStatusCode() >= 400) {
            view.stopLoading();
            view.loadUrl("file:///android_asset/error.html");
        }
        super.onReceivedHttpError(view, request, errorResponse);
    }
});

2. 用JS交互控制重试逻辑，避免快速点击闪屏 #

直接在error.html里让按钮跳转目标URL，会导致WebView重新发起请求时，短暂出现加载间隙（甚至原生错误页）。最好的方式是通过JS与原生交互，让原生代码直接控制WebView的加载流程：

首先在error.html里修改重试按钮的点击事件：

<button onclick="triggerRetry()">重试</button>
<script>
function triggerRetry() {
    // 调用原生提供的方法
    window.webViewBridge.retryTarget();
}
</script>

然后在原生代码中给WebView添加JS接口，控制加载逻辑：

// 先定义目标URL（可以根据实际场景动态传入）
private String targetUrl = "https://your-target-url.com";

// 给WebView添加JS交互接口
webView.addJavascriptInterface(new Object() {
    @JavascriptInterface
    public void retryTarget() {
        // 必须在主线程操作WebView
        runOnUiThread(() -> {
            // 先终止当前可能的加载，再发起新请求
            webView.stopLoading();
            webView.loadUrl(targetUrl);
        });
    }
}, "webViewBridge");

这种方式下，点击重试时是原生直接接管WebView的加载，不会出现中间的错误页闪烁。

3. 优化加载状态过渡，进一步隐藏闪烁 #

如果还是有细微的闪烁，可以给WebView加一个过渡状态：

• 初始化WebView时，先加载自定义错误页；
• 加载目标URL前，显示一个加载动画（比如ProgressBar）覆盖在WebView上；
• 当WebView触发onPageFinished时，再隐藏加载动画。

这样用户看到的是平滑的状态切换，完全感知不到原生错误页的存在。

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