WKWebView Cookie失效求助：部分请求Cookie验证不生效问题排查

我帮你梳理下可能导致Cookie验证时好时坏的几个核心问题，结合你贴的代码逐一分析：

1. 初始请求的URLRequest不可变，导致Cookie Header添加失败 #

你在loadDataOnWebViewWithCookies里创建的是不可变的URLRequest，调用request.addValue(_:forHTTPHeaderField:)根本不会生效——因为不可变对象的属性无法修改。这会导致第一次加载的请求可能完全没带上Cookie，直接触发验证失败。

修复代码： #

func loadDataOnWebViewWithCookies(_ urlString: String) {
    guard let url = URL(string: urlString) else { return }
    // 改用可变的NSMutableURLRequest
    let request = NSMutableURLRequest(url: url)
    
    if let cookies = HTTPCookieStorage.shared.cookies(for: url) {
        let cookieHeader = HTTPCookie.requestHeaderFields(with: cookies)
        if let cookieValue = cookieHeader["Cookie"] {
            // 现在addValue会真正修改请求头
            request.addValue(cookieValue, forHTTPHeaderField: "Cookie")
        }
    }
    
    self.webView.load(request as URLRequest)
}

2. WKWebView与NSHTTPCookieStorage的存储隔离问题 #

从iOS 11开始，WKWebView有自己独立的WKHTTPCookieStore，不再自动共享HTTPCookieStorage.shared里的Cookie。你一直从HTTPCookieStorage拿Cookie手动添加，但WKWebView自身的存储里没有这些Cookie，导致后续页面内的跳转请求（比如点击链接）无法自动带上Cookie，这就是部分场景失效的关键原因之一。

修复方法： #

在加载请求前，把HTTPCookieStorage里的Cookie同步到WKWebView的存储中：

// 可以在WKWebView初始化完成后调用，或者加载请求前执行
func syncCookiesToWebView() {
    guard #available(iOS 11.0, *) else { return }
    
    let cookieStore = webView.configuration.websiteDataStore.httpCookieStore
    guard let sharedCookies = HTTPCookieStorage.shared.cookies else { return }
    
    let group = DispatchGroup()
    for cookie in sharedCookies {
        group.enter()
        cookieStore.setCookie(cookie) {
            group.leave()
        }
    }
    
    group.notify(queue: .main) {
        // 所有Cookie同步完成后，再加载目标URL
        self.loadDataOnWebViewWithCookies("your_target_url")
    }
}

3. 导航代理中的逻辑错误 #

你的decidePolicyFor代理方法存在几个明显问题：

• 判断对象错误：你用webView.url?.host（当前页面的Host）来判断，而不是要跳转的navigationAction.request.url?.host（目标URL的Host），这会导致很多跳转场景下的Cookie处理逻辑不触发。
• 覆盖所有请求头：你直接把cookies赋值给request.allHTTPHeaderFields，这会覆盖原请求的User-Agent、Accept等必要头信息，服务器可能因为请求头不完整拒绝验证。
• 非Host请求的逻辑冗余：部分判断可以简化，避免导航流程异常。

修复后的代理代码： #

func webView(_ webView: WKWebView, decidePolicyFor navigationAction: WKNavigationAction, decisionHandler: @escaping (WKNavigationActionPolicy) -> Void) {
    guard let targetUrl = navigationAction.request.url else {
        decisionHandler(.allow)
        return
    }
    
    // 处理目标URL是指定Host的情况
    if targetUrl.host == Constants.kHost {
        let hasCookie = navigationAction.request.allHTTPHeaderFields?.keys.contains("Cookie") ?? false
        if hasCookie {
            decisionHandler(.allow)
        } else {
            // 创建可变请求，仅添加Cookie头，保留原有所有请求头
            let mutableRequest = (navigationAction.request as? NSMutableURLRequest) ?? NSMutableURLRequest(url: targetUrl)
            if let cookies = HTTPCookieStorage.shared.cookies(for: targetUrl) {
                let cookieHeader = HTTPCookie.requestHeaderFields(with: cookies)
                if let cookieValue = cookieHeader["Cookie"] {
                    mutableRequest.addValue(cookieValue, forHTTPHeaderField: "Cookie")
                }
            }
            webView.load(mutableRequest as URLRequest)
            decisionHandler(.cancel)
        }
    } else {
        // 处理非指定Host的请求
        let (xToken, _) = getTokenAndId()
        if navigationAction.request.value(forHTTPHeaderField: Constants.headersData.token) == xToken {
            decisionHandler(.allow)
        } else {
            let preparedRequest = prepareRequestForHomeService(request: navigationAction.request)
            webView.load(preparedRequest as URLRequest)
            decisionHandler(.cancel)
        }
    }
}

4. 额外需要检查的点 #

• Cookie属性正确性：确认Cookie的domain、path、secure属性是否匹配目标URL。比如HTTPS请求的Cookie必须设置secure=true才会被发送；domain要和目标Host一致（或者父域名）。
• SameSite属性：如果服务器设置了SameSite=Strict，跨站跳转时Cookie会被浏览器拦截，导致验证失效，可以检查服务器的Cookie配置。
• Cookie有效期：确认Cookie是否在有效期内，过期的Cookie会被自动忽略。

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