WKHTTPCookieStorage的setCookie在WebView关闭重启后无返回值问题

我之前也踩过这个坑！你遇到的问题大概率是WKHTTPCookieStorage的异步特性、Cookie属性不匹配，或者WebView初始化时机不对导致的——看起来setCookie没返回值（其实是异步操作你没等它完成），重启后Cookie根本没真正写入到WebView的存储里。

问题根源拆解 #

• WKWebView的Cookie存储操作是异步的，你循环调用setCookie后立刻加载网页，此时Cookie可能还没完成写入，WebView自然读不到
• 重启WebView时，如果没有正确关联默认的共享Cookie存储，或者Cookie的domain、path和目标URL不匹配，也会导致加载时无法读取Cookie
• 部分从HTTPCookieStorage拿到的Cookie可能带有WKWebView不兼容的属性（比如SameSite设置、过期时间）

修复方案（带完整代码） #

1. 等待所有Cookie异步写入完成后再加载网页

用DispatchGroup来监听所有setCookie操作的完成，确保Cookie真正写入后再加载页面：

// 初始化WebView配置时，显式使用默认共享存储（默认就是，但显式写更稳妥）
let webConfig = WKWebViewConfiguration()
webConfig.websiteDataStore = WKWebsiteDataStore.default()

let webView = WKWebView(frame: containerView.bounds, configuration: webConfig)
webView.navigationDelegate = navigationDelegate
containerView.addAndFillSubview(webView)

guard let sharedCookies = HTTPCookieStorage.shared.cookies else {
    // 无Cookie时直接加载页面
    webView.load(URLRequest(url: yourTargetURL))
    return
}

let cookieStore = WKWebsiteDataStore.default().httpCookieStore
let dispatchGroup = DispatchGroup()

// 逐个添加Cookie，用Group跟踪异步操作
for cookie in sharedCookies {
    dispatchGroup.enter()
    cookieStore.setCookie(cookie) {
        dispatchGroup.leave()
    }
}

// 等待所有Cookie写入完成后再加载页面
dispatchGroup.notify(queue: .main) {
    // 可选：调试时打印当前存储的Cookie，确认写入成功
    cookieStore.getAllCookies { storedCookies in
        print("已写入WK存储的Cookie数量：\(storedCookies.count)")
    }
    webView.load(URLRequest(url: yourTargetURL))
}

2. 确保Cookie属性与目标URL匹配

从HTTPCookieStorage拿到的Cookie，可能存在domain或path不匹配的情况：

• 检查Cookie的domain属性：如果目标URL是https://sub.example.com，Cookie的domain应该设为.example.com（带前缀点）或者sub.example.com
• 检查path属性：确保是/或者目标URL的路径前缀，避免路径不匹配导致无法读取
• 处理SameSite属性：如果iOS版本在13.0+，确保Cookie的HTTPCookiePropertyKey.sameSitePolicy设置为.lax、.strict或.none（注意.none需要同时设置isSecure = true）

3. 重启WebView时的注意事项

每次创建新的WKWebView实例时，一定要使用WKWebsiteDataStore.default()，不要创建私有存储（比如WKWebsiteDataStore.nonPersistent()），这样才能共享之前写入的Cookie。

调试小技巧 #

如果还是有问题，可以在加载页面前打印所有存储的Cookie，确认是否真的写入：

cookieStore.getAllCookies { cookies in
    cookies.forEach { print("Cookie: \($0.name) -> \($0.value) | Domain: \($0.domain)") }
}

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