模拟器中WKWebView首次加载始终未认证，后续加载正常

我之前也碰到过这种模拟器专属的奇葩问题，真机上一切顺畅，但模拟器重置后首次加载总掉链子。结合你的描述，核心问题大概率是WKWebView的Cookie异步写入时机和页面加载时机不匹配——你设置Cookie后立刻加载页面，但这时候Cookie还没完全写入到WebView的Cookie存储里，导致第一次请求根本带不上认证Cookie；后续加载时Cookie已经到位，自然就正常了。

给你几个实用的解决方案，按优先级排序：

1. 等待Cookie写入完成后再加载页面 #

WKHTTPCookieStore的setCookie(_:completionHandler:)方法是异步执行的，你必须等它的回调触发后再发起页面请求，才能确保Cookie已经被正确存储并能被WebView读取。

示例代码（Swift）：

// 构造你的认证Cookie
guard let authCookie = HTTPCookie(properties: [
    HTTPCookiePropertyKey.name: "your_auth_cookie_name",
    HTTPCookiePropertyKey.value: "your_valid_auth_value",
    HTTPCookiePropertyKey.domain: "your_target_domain.com", // 必须和页面域名完全匹配
    HTTPCookiePropertyKey.path: "/",
    HTTPCookiePropertyKey.secure: "TRUE", // 如果页面是HTTPS，必须设为true
    HTTPCookiePropertyKey.expires: Date().addingTimeInterval(7*24*3600)
]) else {
    print("Cookie构造失败")
    return
}

// 写入Cookie并等待完成后再加载页面
webView.configuration.websiteDataStore.httpCookieStore.setCookie(authCookie) { [weak self] in
    guard let self = self else { return }
    let targetURL = URL(string: "https://your_target_domain.com/protected_page")!
    self.webView.load(URLRequest(url: targetURL))
}

2. 提前初始化WebView的网站数据存储 #

模拟器擦除数据后，WKWebView的默认websiteDataStore可能需要一点时间完成初始化。你可以在App启动时提前触发初始化，或者在创建WebView后先加载一个空白页面，让存储准备就绪，再设置Cookie和加载目标页面。

示例代码：

// 初始化WebView后先加载空白页
webView.load(URLRequest(url: URL(string: "about:blank")!))
webView.navigationDelegate = self

// 在导航代理的完成回调里处理后续逻辑
func webView(_ webView: WKWebView, didFinish navigation: WKNavigation!) {
    if webView.url?.absoluteString == "about:blank" {
        // 这里调用设置Cookie并加载目标页面的方法
        self.setAuthCookieAndLoadTargetPage()
    }
}

3. 检查Cookie属性的正确性 #

有时候看似正确的Cookie，其实属性有问题导致无法被WebView发送：

• Domain匹配：确保Cookie的domain和页面的域名完全一致（比如页面是app.example.com，Cookie的domain不能随便设为example.com，除非你特意要跨子域共享）
• Secure属性：如果页面是HTTPS协议，Cookie的secure必须设为true，否则不会被发送
• Path属性：通常设为/即可，确保所有路径都能访问到这个Cookie

补充验证方法 #

你可以在第一次加载前，通过httpCookieStore.getAllCookies方法检查Cookie是否已经存在，确认写入是否成功：

webView.configuration.websiteDataStore.httpCookieStore.getAllCookies { cookies in
    print("当前存储的Cookie：\(cookies)")
    // 看看你的认证Cookie是否在列表里
}

这个问题是模拟器特有的，因为真机的Cookie存储初始化流程更稳定，而模拟器擦除数据后相当于完全重置了沙盒，存储的初始化异步性表现得更明显。按照上面的方法调整后，应该就能解决首次加载认证失败的问题了。

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