WKHTTPCookieStore无法获取已设置的Cookie问题求助

这个问题我之前帮好几个开发者排查过，WKHttpCookieStore的“消失术”通常逃不过这几个常见坑，咱们一个个捋：

1. 你可能没等addCookie的异步操作完成就去拿了 #

WKHttpCookieStore的addCookie(_:completionHandler:)是异步执行的——你调用方法后，系统不会立刻把Cookie写入存储，而是在后台完成。如果你的获取代码写在addCookie之后，但没等它的completion回调触发，那这时候存储里自然还没有你的Cookie。

正确姿势：必须在addCookie的completion handler里执行获取操作，或者用async/await包装（iOS 15+支持）：

// 传统闭包方式
let cookie = HTTPCookie(properties: [
    .name: "testCookie",
    .value: "12345",
    .domain: "yourdomain.com",
    .path: "/",
    .expires: Date().addingTimeInterval(3600 * 24)
])!

WKWebsiteDataStore.default().httpCookieStore.add(cookie) {
    // 等添加完成后再获取
    WKWebsiteDataStore.default().httpCookieStore.getAllCookies { cookies in
        print("当前所有Cookie: \(cookies)") // 这里就能看到你加的了
    }
}

// iOS 15+ 用async/await更简洁
Task {
    let cookie = HTTPCookie(properties: [
        .name: "testCookie",
        .value: "12345",
        .domain: "yourdomain.com",
        .path: "/",
        .expires: Date().addingTimeInterval(3600 * 24)
    ])!
    try await WKWebsiteDataStore.default().httpCookieStore.add(cookie)
    let cookies = try await WKWebsiteDataStore.default().httpCookieStore.allCookies()
    print("当前所有Cookie: \(cookies)")
}

2. Cookie的属性不符合WKWebView的校验规则 #

WKWebView对Cookie的属性要求比NSHTTPCookieStorage严格得多，哪怕一个属性不对，都会被默默拒绝存储：

• Domain格式错误：比如你设置的是.yourdomain.com（前面带点），但实际访问的是yourdomain.com，或者反过来；或者domain和你后续要加载的网页域名完全不匹配（比如你加的是google.com的Cookie，但你的WebView加载的是自己的域名）。
• 过期时间无效：如果expirationDate设置成了过去的时间，Cookie会被立刻标记为过期，添加后直接被清理，自然拿不到。
• Secure属性不匹配：如果你的WebView加载的是http页面，但Cookie的secure属性设为true，那这个Cookie不会被发送，甚至可能不会被存储。

检查方法：创建Cookie时打印它的属性，确保所有字段合法且符合你的需求：

let cookieProperties: [HTTPCookiePropertyKey: Any] = [
    .name: "testCookie",
    .value: "12345",
    .domain: "yourdomain.com", // 不要随便加前缀点，除非你要匹配子域名
    .path: "/",
    .expires: Date().addingTimeInterval(3600 * 24),
    .secure: false // 如果是http页面就设为false，https设为true
]
guard let cookie = HTTPCookie(properties: cookieProperties) else {
    print("创建Cookie失败，属性有问题！")
    return
}
print("Cookie属性: \(cookie.properties ?? [:])")

3. 你是不是用了自定义的WKWebsiteDataStore？ #

如果你创建WKWebView时用了WKWebsiteDataStore.nonPersistent()或者自己初始化的dataStore，而你添加Cookie是加到WKWebsiteDataStore.default()里，那这两个存储是完全独立的——你在default里加的Cookie，自定义存储里当然看不到。

确认点：检查你的WKWebView初始化代码，确保dataStore和你添加Cookie的是同一个实例：

// 错误示例：用了非持久化存储，但加到default里
let customDataStore = WKWebsiteDataStore.nonPersistent()
let configuration = WKWebViewConfiguration()
configuration.websiteDataStore = customDataStore
let webView = WKWebView(frame: .zero, configuration: configuration)

// 这时候加到default里的Cookie，customDataStore里是没有的
WKWebsiteDataStore.default().httpCookieStore.add(cookie) { ... }

4. 极端场景：系统的Cookie清理机制 #

如果你的App在后台被系统回收，或者用户手动清理了Safari的网站数据，WKWebsiteDataStore里的Cookie会被清空。不过这种情况是极端场景，如果你是刚添加就拿不到，大概率不是这个原因。

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