Android WebView状态保存实现：避免重复加载已访问URL及端点

要让WebView保存每个已加载URL的会话状态（包括滚动位置、表单内容、浏览历史等），再次访问时直接恢复而非重新加载，可通过WebView自带的状态保存方法配合HashMap存储实现，具体方案如下：

1. 核心配置与状态容器初始化 #

在Fragment中定义存储URL状态的容器，同时配置WebView的基础参数以支持状态保存：

class TempFragment: Fragment() {

    private val urls = listOf("https://stackoverflow.com","https://www.youtube.com","https://www.flipkart.com","https://github.com")
    // 存储每个URL对应的会话状态
    private val urlStateMap = HashMap<String, Bundle>()
    private var currentUrl: String? = null

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        
        // 配置WebView，开启状态保存相关设置
        mBinding.webView.apply {
            settings.apply {
                domStorageEnabled = true // 开启DOM存储，保存页面交互状态
                databaseEnabled = true // 开启数据库存储
                cacheMode = WebSettings.LOAD_CACHE_ELSE_NETWORK // 优先使用缓存
                saveFormData = true // 允许保存表单数据
            }
            isSaveEnabled = true // 启用WebView状态保存功能
        }

        // 恢复Fragment重建前保存的状态
        savedInstanceState?.let {
            val savedMap = it.getSerializable("urlStateMap") as? HashMap<String, Bundle>
            savedMap?.let { map -> urlStateMap.putAll(map) }
            currentUrl = it.getString("currentUrl")
        }

        // 初始化页面：优先恢复上次状态，无状态则加载第一个URL
        currentUrl?.let { restoreUrlState(it) } ?: run {
            currentUrl = urls[0]
            loadUrl(currentUrl!!)
        }

        mBinding.btnSendData.setOnClickListener {
            val randomUrl = urls.random()
            currentUrl = randomUrl
            restoreUrlState(randomUrl)
        }
    }

2. 实现状态保存与恢复方法 #

添加两个核心方法，分别用于保存当前页面状态、恢复指定URL的历史状态：

// 保存当前WebView的会话状态到容器
    private fun saveCurrentUrlState() {
        currentUrl?.let { url ->
            val stateBundle = Bundle()
            mBinding.webView.saveState(stateBundle)
            urlStateMap[url] = stateBundle
        }
    }

    // 恢复指定URL的会话状态，无状态则加载新URL
    private fun restoreUrlState(url: String) {
        urlStateMap[url]?.let { state ->
            saveCurrentUrlState() // 先保存当前页面状态
            mBinding.webView.restoreState(state) // 恢复目标URL的历史状态
        } ?: run {
            saveCurrentUrlState()
            loadUrl(url)
        }
    }

    private fun loadUrl(url: String){
        mBinding.webView.loadUrl(url)
    }

3. 生命周期中持久化状态 #

在Fragment的关键生命周期节点保存状态，避免页面重建或后台切换时丢失数据：

override fun onSaveInstanceState(outState: Bundle) {
        super.onSaveInstanceState(outState)
        saveCurrentUrlState()
        outState.putSerializable("urlStateMap", urlStateMap)
        outState.putString("currentUrl", currentUrl)
    }

    override fun onPause() {
        super.onPause()
        saveCurrentUrlState() // 暂停时保存状态，防止意外退出丢失
    }
}

关键逻辑说明 #

• urlStateMap：通过HashMap关联URL和对应的会话状态Bundle，Bundle中包含WebView的历史记录、滚动位置、表单数据等信息
• saveState()/restoreState()：WebView原生方法，分别用于将当前状态存入Bundle、从Bundle恢复状态
• WebSettings配置：开启DOM存储、缓存等参数，确保页面本地数据能被持久化
• 生命周期处理：在onSaveInstanceState和onPause中保存状态，覆盖页面重建、后台切换等场景

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