Kotlin 如何并行调用同一API端点获取用户信息并合并结果更新UI
Kotlin 批量并行API请求、一次性更新UI实现指南
核心实现目标拆解
- 替代原有循环串行发请求、边返回边更新UI的旧逻辑
- 所有用户对应的GET请求同时发起,将总请求耗时从「所有请求耗时累加」压缩到「单请求最长耗时」
- 等所有请求执行完成、拿到全量结果后,统一触发一次UI更新,避免多次刷新造成的界面闪烁、性能损耗
基础实现方案
Kotlin生态下用协程实现并行请求是最轻量化的方案,不需要额外引入复杂的并发工具:
- 所有网络请求协程在
Dispatchers.IO调度器上执行,避免阻塞主线程 - 用
async包裹每一个独立的用户请求,让请求并行启动,不会等待前一个请求返回才发下一个 - 通过
awaitAll()等待所有并行任务执行完成,拿到全量结果后再切回主线程更新UI
示例代码
// 原有的待查询用户ID数组 val pendingUserIdList: List<Long> = getOriginalUserArray() // 已定义好的挂起式API方法:suspend fun fetchUserInfo(userId: Long): UserInfo lifecycleScope.launch { // 所有网络请求在IO线程执行 val finalUserList = withContext(Dispatchers.IO) { pendingUserIdList .map { userId -> // 为每个用户创建独立的并行请求协程 async { // 可按需调整单个请求的异常处理逻辑 runCatching { fetchUserInfo(userId) }.getOrNull() } } .awaitAll() // 阻塞等待所有协程执行完毕,拿到全部返回结果 } // 全量结果准备完成后,一次性更新UI renderUserList(finalUserList.filterNotNull()) }
同一API端点多请求并行、结果合并的补充说明
上面的实现逻辑本身就适配同一端点的批量请求场景:不管是不同用户ID对应不同路径,还是同一路径带不同查询参数的请求,只要把对应的请求参数放到async块里,就能实现并行发起。
实际落地时可以按需求调整几个细节:
- 并发流控:如果服务端对单IP的并发请求数有限制,可以通过
Semaphore限制并行度,避免触发限流:// 限制最多同时发起5个请求 val requestSemaphore = Semaphore(permits = 5) pendingUserIdList.map { userId -> async { // 拿到信号量许可后才发起请求 requestSemaphore.withPermit { runCatching { fetchUserInfo(userId) }.getOrNull() } } }.awaitAll() - 异常处理策略:如果需要任意一个请求失败就终止整个批量任务,只需要移除单个请求的
runCatching包裹,配合coroutineScope的异常传播机制,单个协程抛错时会自动取消所有未完成的并行请求 - 结果合并逻辑:所有接口返回的结构会按原数组的顺序收集到结果列表里,不需要额外做顺序对齐操作
新旧逻辑效果对比
- 旧逻辑:循环串行发请求,每拿到一个返回结果就写入MutableList、触发一次UI更新;总耗时为所有请求的时间累加,UI存在多次中间状态渲染
- 新逻辑:所有请求并行发起,总耗时约等于所有请求中耗时最长的那一个;全量结果到齐后仅触发一次UI更新
内容的提问来源于stack exchange,提问作者Belphegor
相关产品推荐
相关产品推荐

