我对URLSession的使用有了新的理解

之前做iOS开发的时候，我总觉得URLSession就是用来发个网络请求拿数据的，用法很简单，几行代码就能搞定。直到最近遇到了几个复杂的网络场景，才突然对它的使用有了新的理解。

之前对URLSession的浅层认知

最开始用URLSession的时候，我只会用系统提供的共享会话URLSession.shared，写出来的代码大概是这样的：

// 之前的简单用法
let url = URL(string: "https://ipipp.com/api/test")!
let task = URLSession.shared.dataTask(with: url) { data, response, error in
    if let error = error {
        print("请求出错: \(error)")
        return
    }
    if let data = data {
        // 简单解析数据
        let result = String(data: data, encoding: .utf8)
        print("请求结果: \(result ?? "")")
    }
}
task.resume()

这种用法确实能应付简单的请求场景，但遇到需要自定义超时时间、设置缓存策略、处理后台下载的时候，就完全不知道怎么改了，只能到处找零散的解决方案。

重新理解URLSession的结构

后来仔细看了官方文档，才发现URLSession本身只是一个会话的入口，真正决定请求行为的是URLSessionConfiguration。它有三个常用的配置类型：

• default：默认配置，和URLSession.shared的配置一致，支持磁盘缓存和cookie存储
• ephemeral：临时配置，不会把缓存、cookie存储到磁盘，适合隐私类请求
• background：后台配置，支持应用在后台的时候继续完成上传下载任务

我们可以根据自己的需求创建对应的配置，再初始化URLSession，比如需要设置请求超时时间的话，可以这样写：

// 自定义配置的URLSession
let configuration = URLSessionConfiguration.default
// 设置请求超时时间为10秒
configuration.timeoutIntervalForRequest = 10
// 设置缓存策略为忽略本地缓存，每次都请求服务器
configuration.requestCachePolicy = .reloadIgnoringLocalCacheData
let session = URLSession(configuration: configuration)
let url = URL(string: "https://ipipp.com/api/test")!
let task = session.dataTask(with: url) { data, response, error in
    // 处理请求结果
}
task.resume()

代理方法的妙用

之前我从来没用过URLSession的代理，后来发现很多复杂场景必须用代理才能实现。比如需要监听下载进度、处理重定向、处理证书验证的时候，就需要设置URLSessionDelegate相关的代理。

举个例子，要监听下载进度的话，可以用URLSessionDownloadDelegate：

class DownloadManager: NSObject, URLSessionDownloadDelegate {
    func startDownload() {
        let configuration = URLSessionConfiguration.background(withIdentifier: "com.test.backgroundDownload")
        let session = URLSession(configuration: configuration, delegate: self, delegateQueue: nil)
        let url = URL(string: "https://ipipp.com/api/largeFile")!
        let task = session.downloadTask(with: url)
        task.resume()
    }
    
    // 下载进度回调
    func urlSession(_ session: URLSession, downloadTask: URLSessionDownloadTask, didWriteData bytesWritten: Int64, totalBytesWritten: Int64, totalBytesExpectedToWrite: Int64) {
        let progress = Double(totalBytesWritten) / Double(totalBytesExpectedToWrite)
        print("当前下载进度: \(progress * 100)%")
    }
    
    // 下载完成回调
    func urlSession(_ session: URLSession, downloadTask: URLSessionDownloadTask, didFinishDownloadingTo location: URL) {
        print("下载完成，文件位置: \(location.path)")
    }
}

请求重试的实现思路

之前遇到请求失败的情况，我都是直接在回调里写重试逻辑，后来发现可以结合URLSession的配置和代理，做更通用的重试处理。比如我们可以封装一个带重试次数的请求方法：

func requestWithRetry(url: URL, retryCount: Int, currentCount: Int = 0, completion: @escaping (Data?, Error?) -> Void) {
    let session = URLSession.shared
    let task = session.dataTask(with: url) { data, response, error in
        if let error = error, currentCount < retryCount {
            // 请求失败且还没到最大重试次数，延迟1秒后重试
            DispatchQueue.global().asyncAfter(deadline: .now() + 1) {
                self.requestWithRetry(url: url, retryCount: retryCount, currentCount: currentCount + 1, completion: completion)
            }
        } else {
            completion(data, error)
        }
    }
    task.resume()
}

// 使用的时候最多重试3次
let testUrl = URL(string: "https://ipipp.com/api/test")!
requestWithRetry(url: testUrl, retryCount: 3) { data, error in
    if let data = data {
        print("请求成功，数据长度: \(data.count)")
    } else if let error = error {
        print("请求失败，错误: \(error)")
    }
}

总结

现在再回头看URLSession，才发现它不是一个简单的请求工具，而是一套完整的网络请求解决方案。从配置到代理，再到各种场景的适配，都有对应的设计。之前的理解太片面，只看到了最表层的用法，现在重新梳理之后，不管是处理简单的接口请求，还是复杂的后台下载、重试逻辑，都能更得心应手，也能写出更健壮的网络相关代码。

URLSession网络请求iOS开发数据解析修改时间：2026-05-31 05:54:08