OkHttp 与 Kotlin 协程完美结合：构建高效的异步网络请求

最新推荐文章于 2025-10-26 13:37:47 发布

原创

最新推荐文章于 2025-10-26 13:37:47 发布 · 722 阅读

5 ·

CC 4.0 BY-SA版权

文章标签：

#okhttp #kotlin #开发语言

前言

在现代 Android 开发中，Kotlin 协程已成为处理异步操作的首选方案。将 OkHttp 与协程结合使用，可以创建简洁、高效且易于维护的网络请求架构。本文将深入探讨如何将这两者完美结合，从基础使用到高级技巧，帮助你构建更健壮的应用程序。

一、为什么选择 OkHttp + 协程组合？

1. 传统回调 vs 协程

特性	回调方式	协程方式
代码可读性	嵌套回调，难以维护	线性顺序，逻辑清晰
错误处理	分散在各回调中	集中 try-catch 处理
线程切换	需要手动管理	自动管理，简洁优雅
取消机制	需要手动维护	结构化并发自动取消
学习曲线	较低但难以精通	中等但概念统一

2. 协程核心优势

轻量级线程：比线程更高效，可创建数千个协程
结构化并发：自动管理生命周期和取消操作
挂起函数：用同步方式写异步代码
与 Jetpack 组件深度集成：ViewModel、Lifecycle 等

二、基础集成与配置

1. 添加依赖

// OkHttp
implementation 'com.squareup.okhttp3:okhttp:4.10.0'

// 协程核心
implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core:1.6.4'
implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.6.4'

2. 创建 OkHttpClient 实例

val okHttpClient = OkHttpClient.Builder()
    .connectTimeout(30, TimeUnit.SECONDS)
    .readTimeout(30, TimeUnit.SECONDS)
    .writeTimeout(30, TimeUnit.SECONDS)
    .addInterceptor(HttpLoggingInterceptor().apply {
        level = HttpLoggingInterceptor.Level.BODY
    })
    .build()

三、基本使用模式

1. 简单 GET 请求

suspend fun fetchData(url: String): String {
    val request = Request.Builder()
        .url(url)
        .build()

    return withContext(Dispatchers.IO) {
        okHttpClient.newCall(request).execute().use { response ->
            if (!response.isSuccessful) throw IOException("Unexpected code $response")
            response.body?.string() ?: throw IOException("Empty response")
        }
    }
}

2. 结合 Retrofit 使用（推荐）

interface ApiService {
    @GET("users/{id}")
    suspend fun getUser(@Path("id") userId: String): User
    
    @POST("users")
    su

最低0.47元/天解锁文章