如何在WKWebView中启用第三方Cookie解决页面加载报错？

可以在WKWebView中配置允许第三方Cookie，针对你遇到的页面报错问题，以下是具体的解决方法和代码优化：

问题背景 #

你当前的代码尝试手动处理Cookie，但WKWebView默认的第三方Cookie策略（iOS 11及以上）会限制跨域Cookie的传递，导致加载页面时出现「需为WKWebView启用第三方Cookie」的提示。

解决步骤 #

• 配置WKWebView的Cookie接受策略：iOS 14及以上版本可直接设置Cookie接受规则，更早版本通过共享进程池保证Cookie上下文一致。
• 移除手动Cookie注入逻辑：WKWebView会自动处理Cookie传递，手动添加反而可能引发策略冲突。

修改后的完整代码 #

let targetUrl = "https://www.ck12.org/lms-integration-service/prod/gcaddon.html?launch_key=21C8B2B198A2ABAEE5C97228EBD90836F6BFB34BD1E4302F6762FF7D12F8D904CDA084B4737EF781A18FC25E4F17EA34&app=ltiApp&extra=eyJyZWRpcmVjdCI6Imh0dHBzOi8vZmxleGJvb2tzLmNrMTIub3JnL2Nib29rL2NrLTEyLW1pZGRsZS1zY2hvb2wtZWFydGgtc2NpZW5jZS1mbGV4Ym9vay0yLjAvc2VjdGlvbi8xLjEvcHJpbWFyeS9sZXNzb24vc2NpZW50aWZpYy1leHBsYW5hdGlvbnMtYW5kLWludGVycHJldGF0aW9ucy1tcy1lcy8ifQ=="

class WebViewController: UIViewController, WKNavigationDelegate {
    
    private var webView: WKWebView!
    
    override func viewDidLoad() {
        super.viewDidLoad()
        configureWebView()
    }
    
    private func configureWebView() {
        let config = WKWebViewConfiguration()
        
        // 配置第三方Cookie允许策略
        if #available(iOS 14.0, *) {
            config.websiteDataStore.httpCookieStore.setCookieAcceptPolicy(.always)
            config.defaultWebpagePreferences.allowsContentJavaScript = true
        } else {
            // iOS 11-13 兼容：共享进程池确保Cookie上下文统一
            config.processPool = WKProcessPool()
        }
        
        webView = WKWebView(frame: .zero, configuration: config)
        webView.translatesAutoresizingMaskIntoConstraints = false
        view.addSubview(webView)
        
        // 约束绑定到安全区域
        NSLayoutConstraint.activate([
            view.safeAreaLayoutGuide.leftAnchor.constraint(equalTo: webView.leftAnchor),
            view.safeAreaLayoutGuide.rightAnchor.constraint(equalTo: webView.rightAnchor),
            view.safeAreaLayoutGuide.topAnchor.constraint(equalTo: webView.topAnchor),
            view.safeAreaLayoutGuide.bottomAnchor.constraint(equalTo: webView.bottomAnchor)
        ])
        
        webView.navigationDelegate = self
        loadRequest()
    }
    
    private func loadRequest() {
        DispatchQueue.main.async {
            guard let url = URL(string: targetUrl) else { return }
            var request = URLRequest(url: url)
            request.httpShouldHandleCookies = true
            self.webView.load(request)
        }
    }
    
    // 错误处理逻辑
    func webView(_ webView: WKWebView, didFailProvisionalNavigation navigation: WKNavigation!, withError error: Error) {
        showAlert(for: error)
    }
    
    func webView(_ webView: WKWebView, didFail navigation: WKNavigation!, withError error: Error) {
        showAlert(for: error)
    }
    
    private func showAlert(for error: Error) {
        let alert = UIAlertController(title: "错误", message: "\(error)", preferredStyle: .alert)
        alert.addAction(UIAlertAction(title: "确定", style: .default))
        present(alert, animated: true)
    }
    
    func webView(_ webView: WKWebView, decidePolicyFor navigationAction: WKNavigationAction, decisionHandler: @escaping (WKNavigationActionPolicy) -> Void) {
        decisionHandler(.allow)
    }
    
    // 移除手动添加Cookie的逻辑，避免与系统默认处理冲突
    func webView(_ webView: WKWebView, decidePolicyFor navigationResponse: WKNavigationResponse, decisionHandler: @escaping (WKNavigationResponsePolicy) -> Void) {
        decisionHandler(.allow)
    }
}

补充说明 #

• 若需支持iOS 10及以下版本，苹果已弃用的UIWebView对第三方Cookie限制较少，但不推荐使用；也可通过WKUserScript将Cookie注入页面的方式兼容。
• 确保App的Info.plist中配置了正确的ATS策略，目标URL为HTTPS时默认允许，若为HTTP需添加NSAppTransportSecurity例外配置。

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