You need to enable JavaScript to run this app. Android WebView 配置重定向规则后启动页白屏,无法正常跳转
优惠活动
大模型
产品
解决方案
定价
更多

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.

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.06 04:36:04