如何在Android WebView中保存网页为Web Archive并离线展示？

我来帮你搞定这个离线缓存的问题！你遇到的MHT保存和加载的坑我之前也踩过，咱们一步步来排查和解决：

一、核心问题：saveWebArchive的路径格式错误 #

你之前的代码里犯了一个关键错误：saveWebArchive()接受的是本地文件系统的绝对路径（不带file://前缀），而loadUrl()加载本地文件时需要带file://前缀。之前你给saveWebArchive传了file://开头的路径，导致文件保存失败或者路径无效，自然离线加载时找不到内容。

二、修正保存逻辑（onPageFinished中正确实现） #

首先，我们要在WebView页面加载完成后再保存MHT，确保页面内容完全渲染。这里要注意：

• 用getFilesDir()获取应用内部存储路径（不需要额外权限）
• 给每个URL生成唯一的文件名，避免覆盖
• 保存路径不要加file://前缀

修改后的WebViewClient代码示例：

private String getArchiveFilePath(String url) {
    // 给每个URL生成唯一的文件名，避免冲突
    String fileName = Uri.parse(url).getHost() + "_" + Uri.parse(url).getPath().replace("/", "_") + ".mht";
    return new File(getFilesDir(), fileName).getAbsolutePath();
}

webView.setWebViewClient(new WebViewClient() {
    @Override
    public void onPageFinished(WebView view, String url) {
        super.onPageFinished(view, url);
        // 仅在联网时保存归档
        if (isConnected()) {
            String archivePath = getArchiveFilePath(url);
            // saveWebArchive直接传本地绝对路径，不需要file://
            view.saveWebArchive(archivePath, false, new ValueCallback<String>() {
                @Override
                public void onReceiveValue(String value) {
                    // 这里可以确认保存是否成功，value是保存后的路径
                    Log.d("WebArchive", "归档保存成功：" + value);
                    Toast.makeText(getApplicationContext(), "页面已缓存", Toast.LENGTH_SHORT).show();
                }
            });
        }
    }
});

三、修正离线加载逻辑 #

加载本地MHT时，需要给路径加上file://前缀，同时要先检查文件是否存在，避免“文件未找到”的错误：

if (!isConnected()) {
    String archivePath = getArchiveFilePath(url);
    File archiveFile = new File(archivePath);
    if (archiveFile.exists()) {
        // 加载本地文件需要file://前缀
        webView.loadUrl("file://" + archivePath);
    } else {
        // 如果没有缓存文件，显示错误页面
        webView.loadUrl("file:///android_asset/error_offline.html");
    }
} else {
    // 联网时加载在线页面
    webView.loadUrl(url);
}

四、额外优化建议 #

1. WebView配置优化：确保WebView启用了必要的设置，支持JavaScript和CSS渲染：

WebSettings webSettings = webView.getSettings();
webSettings.setJavaScriptEnabled(true);
webSettings.setDomStorageEnabled(true);
webSettings.setLoadWithOverviewMode(true);
webSettings.setUseWideViewPort(true);

2. MHT的局限性：MHT虽然能保存页面的静态资源，但对于动态加载的内容（比如AJAX获取的新闻）可能无法完全缓存。如果你的页面动态内容较多，后续可以考虑结合WebView的内置缓存机制：

webSettings.setAppCacheEnabled(true);
webSettings.setAppCachePath(getFilesDir().getAbsolutePath() + "/appcache");
webSettings.setCacheMode(WebSettings.LOAD_DEFAULT); // 根据网络状态选择缓存策略

3. 异常日志排查：把之前的Toast改成打印详细异常信息，方便排查问题：

catch (Exception e) {
    Log.e("WebArchiveError", "操作失败", e);
    Toast.makeText(getApplicationContext(), "缓存加载失败：" + e.getMessage(), Toast.LENGTH_LONG).show();
}

最后验证步骤 #

1. 联网状态下启动应用，加载页面后查看Logcat，确认“归档保存成功”的日志
2. 断开网络，重启应用，检查是否能正常加载缓存的MHT页面

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