解决Android WebView无法加载H5页面-CSDN博客

问题背景

Android WebView是开发中常用的组件，用于在应用中嵌入网页内容。但在实际开发中，WebView可能出现无法加载H5页面的问题，原因包括网络权限、混合内容配置、JavaScript支持等。以下是一些常见问题及解决方案。

检查网络权限

确保AndroidManifest.xml文件中已声明网络权限：

<uses-permission android:name="android.permission.INTERNET" />

若未添加此权限，WebView将无法访问网络资源。

启用JavaScript支持

WebView默认禁用JavaScript，需手动开启：

WebView webView = findViewById(R.id.webView);
WebSettings webSettings = webView.getSettings();
webSettings.setJavaScriptEnabled(true);

处理混合内容加载

从Android 5.0开始，WebView默认禁止加载HTTP资源。若H5页面包含HTTP内容，需配置以下代码：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
    webSettings.setMixedContentMode(WebSettings.MIXED_CONTENT_COMPATIBILITY_MODE);
}

设置WebViewClient

未设置WebViewClient可能导致页面跳转失败。自定义WebViewClient以处理页面加载逻辑：

webView.setWebViewClient(new WebViewClient() {
    @Override
    public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {
        view.loadUrl(request.getUrl().toString());
        return false;
    }

    @Override
    public void onReceivedError(WebView view, WebResourceRequest request, WebResourceError error) {
        // 处理加载错误
    }
});

启用DOM存储和数据库

若H5页面使用本地存储，需启用DOM存储：

webSettings.setDomStorageEnabled(true);
webSettings.setDatabaseEnabled(true);

处理SSL证书错误

遇到HTTPS证书错误时，可通过以下方式忽略：

webView.setWebViewClient(new WebViewClient() {
    @Override
    public void onReceivedSslError(WebView view, SslErrorHandler handler, SslError error) {
        handler.proceed(); // 忽略证书错误
    }
});

注意：此方法仅用于测试环境，生产环境应使用有效证书。

调试WebView内容

启用WebView调试功能，方便排查问题：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
    WebView.setWebContentsDebuggingEnabled(true);
}

使用Chrome开发者工具连接设备调试WebView内容。

示例完整代码

以下是一个完整的WebView配置示例：

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        WebView webView = findViewById(R.id.webView);
        WebSettings webSettings = webView.getSettings();

        webSettings.setJavaScriptEnabled(true);
        webSettings.setDomStorageEnabled(true);
        webSettings.setDatabaseEnabled(true);

        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
            webSettings.setMixedContentMode(WebSettings.MIXED_CONTENT_COMPATIBILITY_MODE);
        }

        webView.setWebViewClient(new WebViewClient() {
            @Override
            public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {
                view.loadUrl(request.getUrl().toString());
                return false;
            }

            @Override
            public void onReceivedError(WebView view, WebResourceRequest request, WebResourceError error) {
                // 处理错误
            }
        });

        webView.loadUrl("https://example.com");
    }
}

其他注意事项

确保测试设备网络正常。
检查H5页面是否适配移动端。
若页面加载缓慢，可优化WebView缓存策略：

webSettings.setCacheMode(WebSettings.LOAD_DEFAULT);

通过以上方法，大多数WebView加载问题可以得到解决。