Android WebView 配置重定向规则后启动页白屏,无法正常跳转
问题根因定位
- WebView加载时序颠倒:代码先调用
webView.loadUrl("http://test/start")触发初始加载,之后才通过AsyncTask+Handler post延迟设置WebViewClient,首次加载流程完全没有规则拦截,时序错乱容易触发WebView初始化异常白屏。 - 拦截逻辑返回值错误:低版本
shouldOverrideUrlLoading方法中,未匹配google、yahoo规则的分支直接返回true——该返回值代表拦截当前URL、不执行WebView默认加载逻辑,首个入口链接http://test/start刚好不在匹配列表里,直接被拦截无法加载,是白屏的核心原因。 - 规则判断逻辑失效:高版本
shouldOverrideUrlLoading方法中用==做字符串相等判断,Java中该写法仅比较对象内存地址、不比较字符串内容,域名匹配逻辑永远无法命中。 - 跳转流程逻辑冲突:高版本方法中命中规则后,加载预设目标地址又紧接着加载原始目标URL,造成页面加载覆盖、流程死循环。
- Splash页时序不可控:用AsyncTask后台线程调度Timer做延迟跳转,没有线程安全保护,容易在MainActivity未完成Web初始化时就触发页面切换,加载流程错乱。
- 冗余异步包裹:WebViewClient本身是主线程运行的组件,用AsyncTask后台线程+Handler切主线程设置WebViewClient属于无意义的额外操作,会增加时序不确定性。
代码调整方案
修正后的MainActivity实现
public class MainActivity extends AppCompatActivity { private WebView webView; private final String TAG = "MainActivity"; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); webView = findViewById(R.id.webView); // Web基础配置 WebSettings webSettings = webView.getSettings(); webSettings.setJavaScriptEnabled(true); // 适配高版本系统的混合内容加载规则,避免HTTPS页面加载HTTP资源失败 if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) { webSettings.setMixedContentMode(WebSettings.MIXED_CONTENT_ALWAYS_ALLOW); } // 先完成WebViewClient配置,再触发页面加载,保证所有请求(含首次入口链接)都经过规则拦截 webView.setWebViewClient(new WebViewClient() { // 兼容Android 7.0以下低版本的URL拦截 @Override public boolean shouldOverrideUrlLoading(WebView view, String url) { return matchRedirectRule(view, Uri.parse(url)); } // 兼容Android 5.0以上高版本的URL拦截 @RequiresApi(api = Build.VERSION_CODES.LOLLIPOP) @Override public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) { return matchRedirectRule(view, request.getUrl()); } // 统一抽离的规则匹配逻辑,避免重复代码 private boolean matchRedirectRule(WebView view, Uri targetUri) { String host = targetUri.getHost(); if (host == null) return false; // 精准匹配域名,避免字符串模糊匹配导致的误拦截 if (host.endsWith("google.com")) { view.loadUrl("http://test.com"); // 命中规则:拦截原请求,返回true告知WebView无需执行默认加载 return true; } else if (host.endsWith("yahoo.com")) { view.loadUrl("http://test2.com"); return true; } // 未匹配规则:返回false,交还给WebView执行默认加载 return false; } }); // 所有配置完成后再加载首个入口链接 webView.loadUrl("http://test/start"); } // 补充WebView生命周期管理,避免内存泄漏 @Override protected void onDestroy() { if (webView != null) { webView.destroy(); } super.onDestroy(); } }
修正后的SplashScreenActivity实现
public class SplashScreenActivity extends AppCompatActivity { private static final long DELAY_DURATION = 6000; private final String TAG = "SplashScreenActivity"; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); requestWindowFeature(Window.FEATURE_NO_TITLE); setContentView(R.layout.activity_splash_screen); // 去掉无意义的AsyncTask、后台Timer调度,直接用主线程延迟执行跳转,时序更可控 getWindow().getDecorView().postDelayed(new Runnable() { @Override public void run() { finish(); startActivity(new Intent(SplashScreenActivity.this, MainActivity.class)); } }, DELAY_DURATION); } }
关键调整说明
- 严格遵守WebView配置顺序:必须先完成WebViewClient、WebSettings的所有配置,再调用
loadUrl触发页面加载,保证初始链接、后续跳转的所有请求都能被规则拦截。 - 修正拦截返回值逻辑:
- 命中跳转规则时返回
true,代表当前请求已被处理(加载预设目标地址),WebView无需执行默认加载 - 未匹配规则时返回
false,WebView正常加载原目标地址,从根源解决白屏问题
- 命中跳转规则时返回
- 修正域名匹配逻辑:用Uri解析host做后缀匹配,替换原有的
==字符串比较,保证规则可以正常命中,同时避免泛字符串匹配带来的误拦截。 - 移除冗余异步逻辑:去掉AsyncTask、后台线程Timer等不必要的包裹,所有WebView相关操作都在主线程执行,减少时序错乱的可能。
内容的提问来源于stack exchange,提问作者V.M.
相关产品推荐
相关产品推荐

