如何创建可用于单元测试的HTTPCookieStorage并解决Cookie被忽略问题

问题原因 #

• 构造的URL格式错误：URL(string: "www.example.com")没有包含HTTP/HTTPS scheme，解析后得到的URL实例host属性为空，系统无法匹配Cookie的domain属性，直接拒绝存储。
• Cookie存储实例无效：HTTPCookieStorage没有公开的指定构造器，直接调用HTTPCookieStorage()生成的实例没有完整的存储能力，写入操作会静默失败。
• 属性不匹配：如果Cookie的domain、path属性和传入的URL不匹配，也会被系统的Cookie存储逻辑拦截，无法写入。

解决方案 #

首先修正URL格式，确保携带正确scheme，才能正常解析出host属性：

let url = URL(string: "https://www.example.com")!

方案1：使用独立临时存储（推荐用于单元测试） #

通过URLSessionConfiguration生成完全隔离的内存级Cookie存储，不会污染全局状态，测试结束后自动销毁，完全适配单元测试场景：

// 生成临时会话配置，内置独立Cookie存储
let config = URLSessionConfiguration.ephemeral
guard let testCookieStorage = config.httpCookieStorage else {
    fatalError("创建测试Cookie存储失败")
}
testCookieStorage.cookieAcceptPolicy = .always

// 构造测试Cookie
let cookie = HTTPCookie(properties: [
    .name: "name",
    .value: "value",
    .domain: ".example.com",
    .path: "/",
    .expires: Date(timeIntervalSinceNow: 10),
    .comment: "Test cookie"
])!

// 两种写入方式都可正常生效
testCookieStorage.setCookie(cookie)
// 或 testCookieStorage.setCookies([cookie], for: url, mainDocumentURL: nil)

// 验证写入结果
print(testCookieStorage.cookies ?? [])

方案2：使用系统共享存储（不推荐用于单元测试） #

如果不需要隔离环境，直接使用系统提供的全局共享实例即可正常写入，缺点是会污染全局Cookie状态，影响其他业务逻辑或测试用例：

let cookieStorage = HTTPCookieStorage.shared
cookieStorage.cookieAcceptPolicy = .always
cookieStorage.setCookie(cookie)

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