CoroutineScope中使用Glide批量下载图片时,如何等待所有任务完成再执行后续操作?
问题根因
协程等待逻辑完全失效的核心原因,是Glide的异步执行机制和协程流程没有做桥接:
- 调用
.submit()方法后,Glide会立刻返回一个FutureTarget对象,整个图片下载、解码流程是在Glide内部的后台线程独立异步执行的,完全不会阻塞当前调用downloadPack方法的线程 - 原
downloadPack方法内部只是循环把下载请求提交给Glide,方法体执行完就立刻返回,根本不会等待每个Glide任务的成功/失败回调,因此协程里的async.await()拿到空返回值后,马上就会切回主线程打印"finished"日志。
修复方案
核心是把Glide的异步回调流程桥接成可挂起的协程任务,让协程能真正等待所有下载、保存流程完成后再触发后续逻辑,改造点分为两部分:
改造ImageDownloader
将单张图片的Glide异步请求通过协程挂起函数封装,等单张图片下载保存完成后再结束单个任务,最后通过awaitAll等待所有图片任务全部完成:
ImageDownloader.kt 改造后代码
class ImageDownloader { /** * 批量下载图片包的挂起方法,所有任务完成后才会返回 */ suspend fun downloadPack(context: Context, path: String, pack: PackModel) { // 将每张图片的下载逻辑封装为独立挂起任务 val downloadTasks = pack.images.map { image -> suspendCancellableCoroutine<Unit> { continuation -> Glide.with(context.applicationContext) .asBitmap() .load(image.imageFileUrl) .listener(object : RequestListener<Bitmap> { override fun onLoadFailed(e: GlideException?, model: Any?, target: Target<Bitmap>?, isFirstResource: Boolean): Boolean { // 失败时也要恢复协程,避免协程永久挂起 continuation.resumeWith(Result.failure( e ?: RuntimeException("图片下载失败: ${image.imageFileUrl}") )) return false } override fun onResourceReady(bitmap: Bitmap?, model: Any?, target: Target<Bitmap>?, dataSource: DataSource?, isFirstResource: Boolean): Boolean { try { // 图片解码完成后保存到本地 saveImage(path, pack.id, image.imageFileName, bitmap!!) continuation.resume(Unit) } catch (e: Exception) { continuation.resumeWith(Result.failure(e)) } return true } }).submit() } } // 等待所有图片下载任务执行完成,任意一个失败就抛出异常 downloadTasks.awaitAll() } /** * 保存图片到本地内部存储 */ private fun saveImage(path: String, id: String, fileName: String, bitmap: Bitmap) { // 使用File构造方法自动处理路径分隔符,避免手动拼字符串出现路径错误 val dir = File(path, id) if (!dir.exists()) dir.mkdirs() val file = File(dir, fileName) // use方法自动关闭文件流,避免内存泄漏 FileOutputStream(file).use { out -> bitmap.compress(Bitmap.CompressFormat.PNG, 75, out) } println("done: $fileName") } }
优化Activity层的调用逻辑
替换无生命周期绑定的手动协程作用域,使用组件自带的lifecycleScope避免内存泄漏,在协程内等待下载方法返回后,再执行后续业务:
PackActivity.kt 下载逻辑改造
private fun downloadPack() { // lifecycleScope会自动绑定Activity生命周期,页面销毁时自动取消所有关联协程 lifecycleScope.launch { // 切到IO线程执行磁盘读写、网络下载操作 withContext(Dispatchers.IO) { runCatching { ImageDownloader().downloadPack(applicationContext, path, pack) } }.onSuccess { // 所有图片全部下载保存完成,直接执行后续业务逻辑 println("finished") // 后续业务代码在这里编写 }.onFailure { e -> // 统一处理下载失败场景,比如给用户弹出错误提示 println("下载流程异常: ${e.message}") } } }
关键注意事项
- 不要手动创建无绑定的全局协程作用域,否则Activity销毁后下载任务仍在后台执行,不仅会浪费资源还可能引发内存泄漏
- 所有Glide回调的成功、失败分支都必须恢复挂起的协程,否则协程会永久挂起,后续业务逻辑永远不会执行
- 原代码手动拼接路径的方式存在隐患,如果
path字符串结尾漏了分隔符,会生成错误的文件目录,改用File(path, id)的构造方法可以自动适配路径分隔规则 - 使用
FileOutputStream时通过Kotlin的use扩展方法自动关闭流,避免手动写close操作引发的资源泄漏
内容的提问来源于stack exchange,提问作者user11255734
相关产品推荐
相关产品推荐

