为何WKWebsiteDataStore的setCookie无法添加Cookie？iOS17.2问题

1. HTTPCookie属性类型错误 #

你的代码中.secure属性传了字符串"TRUE"，但HTTPCookiePropertyKey.secure要求的值类型是NSNumber（布尔值），字符串类型会导致Cookie创建无效（即使使用强制解包，生成的Cookie也无法被正常存储）。

修复后的代码：

let websiteDataStore = WKWebsiteDataStore.nonPersistent()

// 修正secure属性的类型为NSNumber布尔值
guard let cookie = HTTPCookie(properties: [
    .domain: "example.com",
    .path: "/",
    .name: "MyCookieName",
    .value: "MyCookieValue",
    .secure: NSNumber(booleanLiteral: true),
    .expires: NSDate(timeIntervalSinceNow: 31_556_926),
]) else {
    print("Cookie创建失败")
    return
}

websiteDataStore.httpCookieStore.setCookie(cookie) {
    websiteDataStore.httpCookieStore.getAllCookies { cookies in
        print(cookies)
    }
}

2. iOS 17+非持久化数据存储的Cookie限制 #

在iOS 17及以上版本中，非持久化的WKWebsiteDataStore必须关联一个活跃的WKWebView实例，否则httpCookieStore不会实际存储Cookie，也不会触发观察者回调。

解决步骤：

• 创建WKWebView并关联当前的nonPersistent数据存储
• 确保WebView完成初始化（比如加载空白页面，或添加到视图层级）

示例代码：

let websiteDataStore = WKWebsiteDataStore.nonPersistent()
let config = WKWebViewConfiguration()
config.websiteDataStore = websiteDataStore

// 创建WebView并初始化（无需显示，只需完成初始化流程）
let webView = WKWebView(frame: .zero, configuration: config)
webView.loadHTMLString("", baseURL: nil)

// 初始化WebView后再设置Cookie
guard let cookie = HTTPCookie(properties: [
    .domain: "example.com",
    .path: "/",
    .name: "MyCookieName",
    .value: "MyCookieValue",
    .secure: NSNumber(booleanLiteral: true),
    .expires: NSDate(timeIntervalSinceNow: 31_556_926),
]) else {
    print("Cookie创建失败")
    return
}

websiteDataStore.httpCookieStore.setCookie(cookie) {
    websiteDataStore.httpCookieStore.getAllCookies { cookies in
        print(cookies) // 此时应输出包含目标Cookie的数组
    }
}

3. 服务器无法接收Cookie的补充检查 #

• 确保Cookie的domain与请求的服务器域名完全匹配（若需兼容子域名，domain应设为.example.com）
• 确保请求使用HTTPS协议（secure属性的Cookie仅会在HTTPS请求中发送）
• 确保WebView加载的页面URL与Cookie的domain、path规则匹配

4. WKHTTPCookieStoreObserver不触发的补充处理 #

• 确保观察者对象被全局持有（避免局部变量被提前释放）
• 在WebView完成初始化后再添加观察者

示例观察者代码：

class CookieObserver: NSObject, WKHTTPCookieStoreObserver {
    func cookiesDidChange(in cookieStore: WKHTTPCookieStore) {
        print("Cookie已更新")
        cookieStore.getAllCookies { cookies in
            print(cookies)
        }
    }
}

// 全局持有观察者实例
let cookieObserver = CookieObserver()

// WebView初始化完成后添加观察者
websiteDataStore.httpCookieStore.add(cookieObserver)

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