如何在Swift中创建持久化URLSession？

Python 中 s = requests.Session() 的核心能力是自动持久化管理Cookie、复用TCP连接、统一全局请求配置，Swift 原生 URLSession 原生支持这套能力，持续报认证错误基本都是配置逻辑错误导致，和框架能力无关。

正确的持久化会话实现 #

必须长期持有同一个会话实例，禁止每次网络请求新建会话对象，否则上下文完全隔离，Cookie等状态无法留存：

import Foundation

// 单例全局持有，和Python中把Session对象赋值给变量反复使用逻辑一致
let persistentSession: URLSession = {
    let config = URLSessionConfiguration.default
    // 开启自动Cookie存取，匹配requests.Session默认行为
    config.httpShouldSetCookies = true
    config.httpCookieAcceptPolicy = .always
    // 使用系统持久化Cookie存储，App重启后登录状态仍可保留
    config.httpCookieStorage = HTTPCookieStorage.shared
    // 统一配置全局公共请求头，等价于给Python Session的headers属性赋值
    config.httpAdditionalHeaders = [
        "User-Agent": "YourApp/1.0",
        "Accept": "application/json"
        // 可添加全局固定的认证头、Content-Type等配置
    ]
    // 如果需要处理重定向的Cookie丢失问题，传入自定义delegate
    return URLSession(configuration: config)
}()

常见认证错误排查点 #

• 每次请求新建URLSession实例：新建实例会生成独立的临时上下文，之前请求拿到的认证Cookie完全不会留存，后续请求带不上身份凭证必然报认证错。
• Cookie策略配置错误：手动关闭httpShouldSetCookies、将Cookie接收策略设为.never，会导致服务端返回的Set-Cookie头被忽略，认证状态无法保存。
• 重定向场景Cookie丢失：默认重定向逻辑不会自动把全局公共头、已有Cookie携带到跳转后的新请求，如果你的认证流程包含3xx跳转，需要实现URLSessionTaskDelegate的重定向回调手动补全参数：

  class PersistentSessionDelegate: NSObject, URLSessionTaskDelegate {
      func urlSession(_ session: URLSession, task: URLSessionTask, willPerformHTTPRedirection response: HTTPURLResponse, newRequest request: URLRequest, completionHandler: @escaping (URLRequest?) -> Void) {
          var redirectRequest = request
          // 给重定向请求补全存储的Cookie
          if let reqUrl = request.url, let cookies = session.configuration.httpCookieStorage?.cookies(for: reqUrl) {
              let cookieHeaders = HTTPCookie.requestHeaderFields(with: cookies)
              redirectRequest.allHTTPHeaderFields = cookieHeaders
              // 补全全局配置的公共请求头（重定向默认不会携带httpAdditionalHeaders内容）
              if let globalHeaders = session.configuration.httpAdditionalHeaders as? [String: String] {
                  redirectRequest.allHTTPHeaderFields?.merge(globalHeaders, uniquingKeysWith: { $1 })
              }
          }
          completionHandler(redirectRequest)
      }
  }
  

• 手动设置请求头覆盖自动注入的Cookie：如果给单个URLRequest手动赋值Cookie字段，会覆盖会话自动注入的有效Cookie，非特殊场景不要手动设置Cookie头。

快速定位方法 #

发起登录请求后，直接打印HTTPCookieStorage.shared.cookies查看服务端返回的认证Cookie（如sessionid、jwt标识Cookie）是否被成功存储；发起后续业务请求时打印请求头，确认Cookie字段是否携带了有效凭证，即可快速定位是存储环节还是请求携带环节的问题。

如果使用Alamofire库，逻辑完全一致：需要长期持有自定义的Session单例实例，不要每次请求新建会话对象，Cookie配置规则和原生URLSession通用。

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