使用async/await模式调用URLSession的download方法如何获取下载进度?
问题原因
使用async/await版本的download(for:delegate:)API时,系统会内部接管下载任务的生命周期以处理异步返回结果,你传入的任务级代理默认不会触发urlSession(_:downloadTask:didWriteData:totalBytesWritten:totalBytesExpectedToWrite:)这类进度回调,只有认证、重定向等非进度类的代理方法会被正常调用。
解决方法
推荐3种适配不同场景的实现方案:
方案1:监听下载任务内置的progress属性(最简单,大文件下载推荐)
每个URLSessionTask都自带内置的进度管理对象,不需要依赖代理回调,直接监听该对象的属性即可获取实时进度:
// 先创建下载任务,不直接await let task = URLSession.shared.downloadTask(with: downloadURL) // 用Combine监听进度变化,也可使用系统KVO var cancellable = task.progress.publisher(for: \.fractionCompleted) .receive(on: DispatchQueue.main) .sink { progress in // 此处拿到0~1的进度值,可直接更新UI print("当前下载进度:\(progress)") } // 启动任务并await最终结果 task.resume() let (downloadedURL, response) = try await task.value // 下载完成后销毁监听即可 cancellable.cancel()
方案2:使用传统全局代理模式(兼容旧代码逻辑)
如果你需要保留原有的代理回调逻辑,可以放弃async/await的便捷写法,初始化URLSession时设置全局代理,所有代理回调都会正常触发:
// 初始化时绑定全局代理 let session = URLSession(configuration: .default, delegate: self, delegateQueue: OperationQueue.main) // 发起普通下载任务 let task = session.downloadTask(with: downloadURL) task.resume() // 你已实现的URLSessionDownloadDelegate进度方法会正常被回调
方案3:使用字节流AsyncSequence逐块处理(仅适合小文件)
如果是小文件下载,也可以直接使用字节流异步序列自己计算进度,注意该方案会把全量文件数据暂存在内存中,大文件场景不推荐使用:
let (byteStream, response) = try await URLSession.shared.bytes(from: downloadURL) let totalExpectedBytes = response.expectedContentLength var downloadedBytes = 0 var fileData = Data() for try await byte in byteStream { fileData.append(byte) downloadedBytes += 1 let currentProgress = Double(downloadedBytes) / Double(totalExpectedBytes) // 实时更新进度 } // 下载完成后将data写入本地指定路径即可 try fileData.write(to: yourLocalSaveURL)
内容的提问来源于stack exchange,提问作者Maciej Swic
相关产品推荐
相关产品推荐

