Android协程块外无法获取数据问题求助及原理解惑

修复后的代码 #

import kotlinx.coroutines.tasks.await
import com.google.android.gms.tasks.Tasks

override suspend fun addProductImagesToFirebaseStorage(
    productImages: List<Uri>
): AddProductImagesResponse {
    return try {
        val downloadUrls = mutableListOf<Uri>()
        
        // 批量生成上传任务
        val uploadTasks = productImages.map { imageUri ->
            categoryImageStorage.reference
                .child("Home/PP/images")
                .putFile(imageUri)
        }
        
        // 等待所有上传任务完成（await()会挂起当前协程，直到所有任务结束）
        val uploadSnapshots = Tasks.whenAllSuccess<UploadTask.TaskSnapshot>(uploadTasks).await()
        
        // 逐个获取下载URL，await()挂起直到URL就绪
        uploadSnapshots.forEach { snapshot ->
            val downloadUrl = snapshot.storage.downloadUrl.await()
            downloadUrls.add(downloadUrl)
            Log.i(TAG, "已添加下载URL: $downloadUrl")
        }
        
        Success(downloadUrls)
    } catch (e: Exception) {
        Failure(e)
    }
}

为什么原代码会返回空列表？ #

1. 回调的异步性：addOnSuccessListener是异步触发的，你的函数在调用Tasks.whenAllSuccess()后会直接执行到Success(downloadUrls)，此时回调还没触发，列表自然为空。
2. 协程的“火并忘记”特性：你在回调里用CoroutineScope(Dispatchers.Default).launch启动的协程是异步执行的，不会阻塞当前线程。所以回调里的Log.i("Outside the block")会先于协程内的downloadUrls.add()执行，函数返回时列表依然是空的。

协程核心原理讲解 #

1. 挂起函数（suspend） #

挂起函数是协程的核心特性，它能在不阻塞线程的情况下暂停执行，直到异步操作完成后自动恢复。Firebase通过kotlinx-coroutines-play-services库提供了await()扩展函数，把Task的异步回调转换成挂起调用，让代码逻辑看起来像同步执行，实际却是非阻塞的。

2. 协程的两种执行模式 #

• Fire-and-Forget（火并忘记）：用launch启动协程时，不会等待协程执行完成，适合不需要获取结果的异步操作（比如更新UI日志）。
• 等待结果：用await()（包括挂起函数的await）会暂停当前协程，直到异步操作返回结果，适合需要获取返回值的场景（比如你这里获取下载URL）。

3. Suspend函数的上下文要求 #

suspend函数必须在协程体内或者另一个suspend函数中调用，因为它需要依赖协程上下文来管理挂起和恢复流程。你原代码直接调用downloadUrl.await()报错，就是因为当时不在协程上下文里。

4. 避免手动创建CoroutineScope #

在suspend函数内手动创建CoroutineScope会导致新协程脱离当前的协程上下文，无法被上层协程的取消操作影响，容易引发内存泄漏或未预期的行为。正确的做法是利用现有的协程上下文，或者通过挂起函数等待结果。

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