前言
安卓客户端套用WebView展示一些用户协议与说明似乎已然变成时代的主流,大部分应用都有类似的页面。在最近一期的业务开发中,我们项目组遇到了一个这样一个奇葩的问题,在网络不稳定的情况下,前端H5页面显示过程中会频繁收到WebViewClient回调TimeOut事件,导致用户体验极差。对于此类问题,对于客户端开发,通常都是甩给Web前端去调查为何会出现TimeOut,但是本着对技术的专研精神,还是要进一步窥探一下其中的原理。
客户端超时处理
我们都知道,如果原生的WebView不做Web错误收集处理,当H5页面加载出错的时候,WebView会显示网页原生的错误信息,因为是系统原生,页面通常会比较丑陋,如图1-1所示。
客户端常规的解决方案是监听WebViewClient的onReceivedError回调,当有错误信息的时候将WebView进行隐藏,同时展示自己根据设计稿进行设计的网络错误布局。
@Override
public void onReceivedError(WebView view, WebResourceRequest request, WebResourceError error) {
super.onReceivedError(view, request, error);
ManualLogUtil.logMessage("onReceivedError: error = " + error);
ManualLogUtil.logMessage("onReceivedError: " + error.getDescription() +";" + error.getErrorCode());
manualView.showNetErrorView();
此种处理方案对于常规的网络环境没有任何问题,但是在极端的网络环境下(如弱网,时断时连的网络),如果Web端存在多Tab页同时加载的情况(如图1-2所示),就会发生高频超时问题,即onReceivedError不断回调,不断的返回CODE_TIME_OUT(-8),安卓端频繁收到TimeOut将导致页面正常浏览过程中,突然切换H5页为自定义的网络异常页面。由于本文意在通过安卓端解决问题,所以暂且忽略前端切换Tab为什么会返回超时事件。
主页面加载与Tab加载
我们知道安卓端的WebView其实是相当于一个浏览器,在H5也的主URL加载完成之后,其实后续的操作Web页完全可以自己完成,即H5页的第一个TAB加载后,此时断网,点击第二个TAB页,Web端是完全可以进行自己处理异常静态页面的显示,由此可见,安卓端其实只需要关心第一次主URL加载是否超时即可。
翻看WebView的源码发现,WebView并没有提供诸如setTimeOut类的方法,网上普遍的解决方案都是自己写一个Timer进行URL加载监控。
即我们在WebView开始load的时候启动计时器,在WebViewPage第一次加载完成的时候停止并销毁计时器,如果在自定义超时时间内Page依旧没有加载完成,则触发自定义超时。
启动计时器
/** 初始化事件 **/
private void initEvent(){
initWebSettings();
timeOutPresenter = new TimeOutPresenter(manualView);
//加载URL 启动Timer
timeOutPresenter.startTimer();
webView.loadUrl(ManualConstants.WEB_URL);
setWebClient();
/** 计时任务 **/
class TimeOutTimerTask extends TimerTask {
@Override
public void run() {
currentTime++;
ManualLogUtil.logMessage("currentTime is : " + currentTime);
if (currentTime > 9) {
dealWithTimeout();
/** 处理页面超时事件 **/
private void dealWithTimeout(){
ManualLogUtil.logMessage("dealWithTimeout isPageLoaded is : " + isPageLoaded);
if(!isPageLoaded){
ManualLogUtil.logMessage("showNetErrorView");
manuView.showNetErrorView();
stopTimer();
终止计时器
public void onReceivedError(WebView view, WebResourceRequest request, WebResourceError error) {
super.onReceivedError(view, request, error);
ManualLogUtil.logMessage("onReceivedError: error = " + error);
ManualLogUtil.logMessage("onReceivedError: " + error.getDescription() +";" + error.getErrorCode());
if(error.getErrorCode()!=ManualConstants.CODE_TIME_OUT){
manualView.showNetErrorView();
}else {
manualView.showLoadingView();
终止计时器这里需要注意,因为我们已经有了自己的超时机制,所以这里不再需要接收onReceivedError的TimeOut事件,通过IF条件过滤即可。