Android Kotlin：如何在WebView中保存授权Cookie？

你当前的代码存在两个核心问题：

1. 语法错误：shouldOverrideUrlLoading方法内部嵌套了onPageFinished，导致代码无法正常编译运行。
2. 时机错误：在页面加载完成后才设置Cookie接受策略，此时授权请求已完成，Cookie无法被正确捕获。

以下是修正后的完整解决方案：

1. 初始化阶段配置WebView与Cookie策略 #

在WebView实例创建后立即配置Cookie规则，确保所有请求都能正确处理Cookie：

val webView = findViewById<WebView>(R.id.webView)
val webSettings = webView.settings

// 基础配置（根据业务需求调整）
webSettings.javaScriptEnabled = true // 授权页面通常需要JS支持
webSettings.domStorageEnabled = true // 启用DOM存储，部分授权流程依赖
webSettings.cacheMode = WebSettings.LOAD_DEFAULT // 保持默认缓存模式

// 配置Cookie接受策略
val cookieManager = CookieManager.getInstance()
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
    // Android 5.0+ 允许第三方Cookie
    cookieManager.setAcceptThirdPartyCookies(webView, true)
} else {
    // 旧版本直接允许Cookie
    cookieManager.setAcceptCookie(true)
}

// 开启Cookie持久化
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
    cookieManager.flush() // 强制将Cookie写入磁盘
} else {
    CookieSyncManager.createInstance(this) // 旧版本同步工具
}

2. 正确实现WebViewClient #

避免方法嵌套，在合适时机处理页面加载逻辑并确保Cookie持久化：

webView.webViewClient = object : WebViewClient() {
    override fun shouldOverrideUrlLoading(view: WebView?, request: WebResourceRequest?): Boolean {
        // 可在此拦截授权回调URL（如果需要）
        return super.shouldOverrideUrlLoading(view, request)
    }

    override fun onPageFinished(view: WebView?, url: String?) {
        super.onPageFinished(view, url)
        
        // 页面加载完成后，确认Cookie并持久化
        url?.let {
            val currentCookies = cookieManager.getCookie(it)
            Log.d("CookieDebug", "当前页面Cookie: $currentCookies")
        }

        // 确保Cookie写入磁盘
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
            cookieManager.flush()
        } else {
            CookieSyncManager.getInstance().sync()
        }
    }
}

关键注意事项 #

• 域名匹配：确保授权接口返回的Set-Cookie头中，domain属性与WebView访问的域名一致，否则Android 5.0+会严格拦截第三方Cookie。
• Cookie属性：检查Set-Cookie的path、expires/max-age属性，确保Cookie的作用范围和有效期符合需求。
• 生命周期管理：若需长期保存Cookie，不要在WebView销毁时调用removeAllCookies；仅需会话级Cookie可在退出时清理。
• 测试场景：测试前清除应用缓存，避免旧Cookie干扰测试结果。

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