You need to enable JavaScript to run this app. CoroutineScope中使用Glide批量下载图片时,如何等待所有任务完成再执行后续操作?
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.29 11:54:03