Android WebView的saveState与restoreState异常，状态恢复方案咨询

原代码存在多处错误，无法正确实现“存储每个URL的最后访问状态并恢复”的需求，具体问题如下：

• 重复配置WebView客户端：每次调用loadUrl()都重新创建并设置WebViewClient和WebChromeClient，会覆盖之前的客户端实例，导致逻辑混乱，且完全没必要重复配置。
• 变量混淆错误：方法参数是urltoLoad，但判断状态和加载时用的是未定义的appUrl，导致逻辑完全错位；保存状态时用appUrl作为key，会导致所有URL的状态都存在同一个key下，互相覆盖。
• 状态保存时机与key错误：在onProgressChanged中判断进度100%时保存状态，不如onPageFinished可靠（进度100%不代表页面完全渲染完成），且保存时用的key不是当前实际加载的URL，导致状态无法和正确的URL关联。
• 状态恢复逻辑顺序错误：先设置客户端，再执行状态恢复，但WebView的状态恢复需要在基础配置完成后执行，且重复配置客户端会干扰状态恢复的正确性。
• 未初始化变量：lastVisitedUrl没有初始化，首次判断时会出现空指针或逻辑错误。
• 不必要的并发集合：如果仅在UI线程操作状态Map，ConcurrentHashMap是多余的，普通HashMap即可。

以下是修正后的代码，核心思路是：初始化时一次性配置WebView的基础参数与客户端，加载URL时优先恢复对应状态，页面加载完成后保存当前URL的状态：

// 用普通HashMap存储URL与对应状态，仅在UI线程操作无需并发集合
private val urlStateMap = HashMap<String, Bundle>()
private var lastVisitedUrl: String? = null

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    // 初始化WebView的基础配置，只执行一次
    initWebView()
    // 首次加载示例URL
    loadUrl("some url")
}

private fun initWebView() {
    val webView = mBinding.webView
    // 启用JavaScript等必要配置（根据你的需求调整）
    webView.settings.javaScriptEnabled = true
    webView.settings.domStorageEnabled = true
    
    // 添加JavaScript接口，仅初始化一次
    webView.addJavascriptInterface(myJavaInterface, "webkit")
    
    // 设置WebViewClient，仅初始化一次
    webView.webViewClient = object : WebViewClient() {
        override fun onPageStarted(view: WebView, url: String, favicon: Bitmap?) {
            super.onPageStarted(view, url, favicon)
            mBinding.loading.visibility = View.VISIBLE
        }

        override fun onPageFinished(view: WebView, url: String) {
            super.onPageFinished(view, url)
            mBinding.loading.visibility = View.GONE
            // 页面加载完成后，保存当前URL的状态
            saveCurrentUrlState(url, view)
        }

        override fun onReceivedHttpError(
            view: WebView?,
            request: WebResourceRequest?,
            errorResponse: WebResourceResponse?,
        ) {
            super.onReceivedHttpError(view, request, errorResponse)
            Log.d(WEBVIEW_TAG, "加载失败：${errorResponse?.reasonPhrase}")
        }
    }

    // 设置WebChromeClient，仅初始化一次
    webView.webChromeClient = object : WebChromeClient() {
        override fun onProgressChanged(view: WebView?, newProgress: Int) {
            super.onProgressChanged(view, newProgress)
            // 这里仅处理进度展示，状态保存移到onPageFinished
        }
    }
}

private fun saveCurrentUrlState(url: String, webView: WebView) {
    if (url == lastVisitedUrl) return
    lastVisitedUrl = url
    val stateBundle = Bundle()
    webView.saveState(stateBundle)
    // 用当前URL作为key存储状态
    urlStateMap[url] = stateBundle
    Log.d(WEBVIEW_TAG, "已保存URL状态：$url")
}

private fun loadUrl(urlToLoad: String) {
    val webView = mBinding.webView
    // 判断是否存在已保存的状态
    urlStateMap[urlToLoad]?.let { savedState ->
        // 恢复状态，注意：restoreState会自动加载对应的URL
        val isRestored = webView.restoreState(savedState)
        if (isRestored) {
            Log.d(WEBVIEW_TAG, "已恢复URL状态：$urlToLoad")
            return
        }
    }
    // 没有保存的状态或恢复失败，直接加载URL
    Log.d(WEBVIEW_TAG, "首次加载URL：$urlToLoad")
    webView.loadUrl(urlToLoad)
}

关键说明 #

1. WebView初始化分离：将WebView的基础配置、客户端设置、JS接口添加等操作放在initWebView()中，仅执行一次，避免重复配置导致的逻辑问题。
2. 状态保存时机：在onPageFinished中保存状态，确保页面完全加载完成后再存储最新状态，且用当前URL作为key，保证状态与URL一一对应。
3. 状态恢复逻辑：加载URL时优先尝试恢复对应状态，restoreState()方法会自动加载对应的URL，无需再调用loadUrl()；如果恢复失败（比如状态损坏），再回退到loadUrl()加载。
4. 变量修正：统一使用方法参数urlToLoad进行逻辑判断，避免变量混淆；初始化lastVisitedUrl，防止空指针。

内容的提问来源于stack exchange，提问作者The Abhishek Kumar