Android：无法通过JS接口刷新WebView及页面加载异常问题

我来帮你搞定这两个WebView的问题，咱们一步步拆解解决：

一、解决JS接口无法刷新WebView的问题 #

问题根源很明确：JS接口的方法是在JavaScript线程里执行的，但WebView的UI操作（比如刷新）必须在Android的**主线程（UI线程）**中进行，直接调用会触发线程异常。

解决方案就是在showHTML方法里手动切换到UI线程执行刷新操作，用runOnUiThread或者Handler都可以：

@JavascriptInterface
public void showHTML(String html) {
    scrapePage(html);
    
    // 切换到UI线程执行WebView刷新
    runOnUiThread(new Runnable() {
        @Override
        public void run() {
            // 方式1：重新加载当前页面
            webView.reload();
            // 方式2：如果需要重新加载指定URL，用下面的代码
            // webView.loadUrl("你的目标页面URL");
        }
    });
}

如果是在Fragment里，就用requireActivity().runOnUiThread(...)；要是在自定义工具类里，记得传入Context，通过((Activity)context).runOnUiThread(...)来切换线程。

二、处理页面未完全加载或AJAX请求失败时的刷新需求 #

这个场景要分两部分处理：页面整体加载失败和AJAX请求失败——因为WebView默认只能监听主页面的加载状态，没法直接捕获AJAX的错误。

1. 监听页面整体加载状态与错误 #

通过设置WebViewClient来捕获页面加载完成、加载失败的事件，在对应时机触发刷新：

webView.setWebViewClient(new WebViewClient() {
    @Override
    public void onPageFinished(WebView view, String url) {
        super.onPageFinished(view, url);
        // 页面加载完成后，注入监听AJAX错误的JS代码
        view.loadUrl("javascript:" +
            "(function() {" +
            "   var originalXHROpen = XMLHttpRequest.prototype.open;" +
            "   XMLHttpRequest.prototype.open = function(method, url) {" +
            "       this.addEventListener('error', function() {" +
            "           // 通知Android端AJAX请求失败" +
            "           HtmlViewer.notifyAjaxError();" +
            "       });" +
            "       originalXHROpen.apply(this, arguments);" +
            "   };" +
            "})();"
        );
        // 执行你原本的HTML抓取逻辑
        view.loadUrl("javascript:HtmlViewer.showHTML('<html>'+document.getElementsByTagName('html')[0].innerHTML+'</html>');");
    }

    @Override
    public void onReceivedError(WebView view, WebResourceRequest request, WebResourceError error) {
        super.onReceivedError(view, request, error);
        // 页面加载失败时，延迟2秒刷新（避免频繁刷新）
        runOnUiThread(() -> {
            new Handler().postDelayed(() -> view.reload(), 2000);
        });
    }
});

2. 捕获AJAX请求失败并触发刷新 #

先在你的WebScraper类里加一个新的JS接口方法，用来接收AJAX错误的通知：

public class WebScraper {
    private WebView webView;
    private Context context;

    // 建议传入WebView和Context，方便后续操作
    public WebScraper(WebView webView, Context context) {
        this.webView = webView;
        this.context = context;
    }

    @JavascriptInterface
    public void showHTML(String html) {
        scrapePage(html);
    }

    @JavascriptInterface
    public void notifyAjaxError() {
        // AJAX请求失败，切换到UI线程刷新页面
        ((Activity)context).runOnUiThread(() -> {
            new Handler().postDelayed(() -> webView.reload(), 2000);
        });
    }

    private void scrapePage(String html) {
        // 你的HTML处理逻辑
    }
}

3. 额外优化：避免无限刷新循环 #

• 加延迟刷新（比如2秒），防止网络波动时频繁刷新
• 可以记录刷新次数，超过3次就停止，避免无限循环
• 刷新前先检查网络状态，确保有网再刷新

最后几个必看注意事项 #

• 一定要开启WebView的JavaScript支持：webView.getSettings().setJavaScriptEnabled(true);
• Android 11及以上版本，JS接口类如果是内部类，要在AndroidManifest.xml里声明android:exported="false"；如果是外部类，确保类是公开的
• 抓取HTML时注意转义特殊字符，比如把抓取逻辑改成下面这样，避免JS语法错误：

  javascript:HtmlViewer.showHTML(JSON.stringify('<html>'+document.getElementsByTagName('html')[0].innerHTML+'</html>'))
  

  然后在Android端用JSON.parse()解析字符串即可。

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