Android WebView加载出错时自定义错误页面

最新推荐文章于 2025-06-04 08:51:59 发布

原创最新推荐文章于 2025-06-04 08:51:59 发布 · 4.5k 阅读

1 ·

CC 4.0 BY-SA版权

Android 同时被 2 个专栏收录

52 篇文章

订阅专栏

我的学习分享

21 篇文章

订阅专栏

在Android开发中，当WebView加载URL失败时，通常会显示默认的错误页面。为了提供更好的用户体验，开发者可以创建自定义错误页面来替代默认页面。实现这一功能主要通过在WebViewClient的onReceivedError, onReceivedHttpError和onReceivedError方法中进行处理，并在调用super之前执行。关键步骤包括先使用view.loadUrl("about:blank")清空错误页面，然后将自定义的视图添加到WebView中。" 8776583,469170,LevelDB源码解析：版本控制与DB接口深入,"['数据库', '源码分析', '数据存储', 'LevelDB框架']

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

开发中难免使用WebView加载url的情况，存在很多加载失败的原因，网络异常，404等等，这个时候会给用户展示一个机器人的错误页面，这个很不友好，一般会自己做一个页面覆盖这个错误页面，这个功能主要是通过在WebViewClient的几个方法中做处理，如下代码，需要在onReceivedError，onReceivedHttpError，onReceivedError这三个方法中做处理，需要在super之前做处理，需要注意的是很必要的一句代码是 view.loadUrl("about:blank");否则始终会出现错误页面，然后我们把自定义的view addView到WebView，就这样。

 webView.setWebViewClient(new WebViewClient() {

            @Override
            public void onReceivedError(WebView view, int errorCode, String description, String failingUrl) {
                view.loadUrl("about:blank");// 避免出现默认的错误界面
                view.removeAllViews();
                int width = (int) DeviceUtils.getScreenWidth(CategoryDetailActivity.this);
                int height = (int) DeviceUtils.dip2px(CategoryDetailActivity.this, 230);
                view.addView(hintWeb, width, height);
                iv_live_cover.setVisibility(View.GONE);
                webViewProgress.setVisibility(View.GONE);
                tv_network_error_hint.setVisibility(View.VISIBLE);
                super.onReceivedError(view, errorCode, description, failingUrl);
            }

            @RequiresApi(api = Build.VERSION_CODES.LOLLIPOP)
            @Override
            public void onReceivedHttpError(WebView view, WebResourceRequest request, WebResourceResponse errorResponse) {
                view.loadUrl("about:blank");// 避免出现默认的错误界面
                view.removeAllViews();
                int width = (int) DeviceUtils.getScreenWidth(CategoryDetailActivity.this);
                int height = (int) DeviceUtils.dip2px(CategoryDetailActivity.this, 230);
                view.addView(hintWeb, width, height);
                int statusCode = errorResponse.getStatusCode();
                if (404 == statusCode || 500 == statusCode) {
                    iv_live_cover.setVisibility(View.GONE);
                    webViewProgress.setVisibility(View.GONE);
                    tv_network_error_hint.setVisibility(View.VISIBLE);
                }
                super.onReceivedHttpError(view, request, errorResponse);
            }

            @Override
            public void onReceivedError(WebView view, WebResourceRequest request, WebResourceError error) {
                view.loadUrl("about:blank");// 避免出现默认的错误界面
                view.removeAllViews();
                int width = (int) DeviceUtils.getScreenWidth(CategoryDetailActivity.this);
                int height = (int) DeviceUtils.dip2px(CategoryDetailActivity.this, 230);
                view.addView(hintWeb, width, height);
                iv_live_cover.setVisibility(View.GONE);
                webViewProgress.setVisibility(View.GONE);
                tv_network_error_hint.setVisibility(View.VISIBLE);
                super.onReceivedError(view, request, error);
            }

            @Override
            public void onPageStarted(WebView view, String url, Bitmap favicon) {
                super.onPageStarted(view, url, favicon);
                webViewProgress.setVisibility(View.VISIBLE);
//                tv_network_error_hint.setVisibility(View.GONE);
            }

            @Override
            public void onPageFinished(WebView view, String url) {
                super.onPageFinished(view, url);
                iv_live_cover.setVisibility(View.GONE);
                webViewProgress.setVisibility(View.GONE);
                if (!NetworkUtils.isAvailable(CategoryDetailActivity.this)) {
                    tv_network_error_hint.setVisibility(View.VISIBLE);
                } else {
                    tv_network_error_hint.setVisibility(View.GONE);
                }
            }
        });