iOS 17部分设备WKWebView Cookie同步异常问题求助

我们的应用在部分升级至iOS 17的设备上出现Cookie同步异常，存在部分Cookie丢失情况。

应用Cookie同步机制 #

• 通过REST请求Header获取认证Token；
• 将Token同步至NSHTTPCookieStorage与WKHTTPCookieStore；
• WKWebView请求自动附加WKHTTPCookieStore中的Cookie至HTTP请求。

问题详情 #

iOS 17部分设备上，WKWebView会随机遗漏部分Cookie的附加。

影响范围 #

• 公司内部3人反馈该问题；
• 已有8-10位终端用户上报；
• 一台iPhone 14 Pro设备可稳定复现该问题。

已尝试的临时修复与解决方案 #

临时修复 #

重置iOS设备默认设置对部分用户有效，但在可复现设备上无效。

已尝试的解决方案 #

通过setHTTPShouldHandleCookies禁用自动同步后，手动将Cookie设置到WKWebView的NSMutableRequest中，多数场景有效，但应用未退前台直接登出再登录时失效。

可行解决方案建议 #

1. 确保Cookie同步的原子性与时机 #

向WKHTTPCookieStore添加Cookie时，必须等待操作完成后再发起WKWebView请求，利用setCookie(_:completionHandler:)的回调确认写入成功：

let cookie = HTTPCookie(properties: [
    HTTPCookiePropertyKey.name: "token",
    HTTPCookiePropertyKey.value: "your_auth_token",
    HTTPCookiePropertyKey.domain: "your_domain.com",
    HTTPCookiePropertyKey.path: "/"
])!
webView.configuration.websiteDataStore.httpCookieStore.setCookie(cookie) {
    // Cookie写入完成后再加载请求
    self.loadTargetWebPage()
}

登出流程中，先清空WKHTTPCookieStore和NSHTTPCookieStorage的所有相关Cookie，等待清空回调完成后再执行登录写入新Cookie，避免竞态问题。

2. 统一Cookie存储，避免双源冲突 #

放弃同时维护NSHTTPCookieStorage与WKHTTPCookieStore，仅使用WKHTTPCookieStore管理Cookie。iOS 17对WKWebView的Cookie隔离逻辑有调整，双存储易导致同步延迟或数据不一致。

3. 手动注入Cookie时完整覆盖Header字段 #

手动注入Cookie时，将所有需要的Cookie拼接成完整字符串，直接覆盖请求的Cookie Header，避免追加导致的字段混乱：

let request = NSMutableURLRequest(url: URL(string: "your_web_url")!)
let fullCookieString = "token=your_new_token; user_id=123"
request.setValue(fullCookieString, forHTTPHeaderField: "Cookie")
webView.load(request as URLRequest)

登出再登录场景下，确保新Cookie完全替换旧值，检查并移除所有过期或无效的Cookie条目。

4. 监听Cookie变化，触发请求重发 #

通过KVO监听WKHTTPCookieStore的cookies属性变化，当检测到目标Cookie缺失或更新时，重新加载WKWebView请求：

override func observeValue(forKeyPath keyPath: String?, of object: Any?, change: [NSKeyValueChangeKey : Any]?, context: UnsafeMutableRawPointer?) {
    guard keyPath == "cookies", let cookieStore = object as? WKHTTPCookieStore else {
        super.observeValue(forKeyPath: keyPath, of: object, change: change, context: context)
        return
    }
    cookieStore.getAllCookies { cookies in
        let hasTargetCookie = cookies.contains { $0.name == "token" }
        if !hasTargetCookie {
            self.webView.reload()
        }
    }
}

// 添加监听
webView.configuration.websiteDataStore.httpCookieStore.addObserver(self, forKeyPath: "cookies", options: .new, context: nil)

5. 适配iOS 17 Cookie政策要求 #

确保Cookie设置正确的SameSite属性（如SameSite=Lax），同时验证域名、路径等属性与请求URL完全匹配，避免因iOS 17的隐私限制导致Cookie被拦截。

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