1. 项目概述为什么“AndroidKMP之网络请求”不是一句口号而是工程落地的分水岭KMP—— Kotlin Multiplatform Mobile不是个新词但真正把它用在生产级 Android 网络请求场景里很多人还在卡在“能跑通”和“敢上线”之间。我带过三个跨端项目前两个用的是纯 Kotlin/JVM Retrofit OkHttp 的老路子第三个才真正把 KMP 的网络层从 iOS 和 Android 共享逻辑里抠出来、压进 release 包、跑满 30 天灰度最后全量切走。这中间踩的坑比写十个 MVP 架构还扎实。“AndroidKMP之网络请求”这个标题表面看是技术选型组合实际拆开是三重硬仗第一关KMP 共享模块如何不被 Android 的生命周期、Context、主线程限制反向绑架第二关网络层抽象必须同时满足 iOS 的 URLSession 语义、Android 的 OkHttp 能力、以及 JS 的 fetch 兼容性万一后续要加 Web第三关调试链路不能断——你不能在 Android Studio 里打不了断点、看不到 Request/Response、查不出 TLS 握手失败的真实原因。热搜词里反复出现的“android studio 怎么设置中文”“android sdk 下载”“adb shell sh /storage/emulated/0/...”恰恰说明大量开发者还在环境搭建阶段打转更别说把 KMP 网络层跑稳了。它解决的不是“能不能发请求”而是“能不能在 2024 年的 Android 工程里让网络请求这件事彻底脱离平台绑定变成可测试、可复用、可审计、可降级的业务能力单元”。适合谁不是刚学完 Kotlin 语法的新手而是已经用过 Retrofit Coroutines 写过至少 5 个真实 API、遇到过 Cookie 同步失效、OkHttp 连接池泄漏、或 Retrofit Converter 与 Gson 版本冲突的中级以上 Android 开发者。如果你正被“iOS 和 Android 两套网络 SDK 维护成本翻倍”“每次改个 Header 都要双端同步提 PR”“Mock 测试要写两套 MockWebServer”这些问题咬住那这篇就是为你写的实操笔记——不讲原理图不列官方文档链接只说我在 vivo 某健康类 App、小米某 IoT 控制台、以及一个出海社交 App 里怎么把 KMP 网络层从 demo 跑成线上主力模块的全过程。2. 整体架构设计为什么放弃 Ktor Client而选择自建 KMP HTTP 抽象层2.1 Ktor Client 的诱惑与陷阱Ktor 是 JetBrains 官方主推的 KMP 网络方案文档漂亮、DSL 清晰、iOS/Android/JS 三端开箱即用。我最早也用它搭了个 PoC跑通了 GET 请求但一进真实场景就露馅Android 端无法接管 OkHttp 实例Ktor 默认用 JVM 的 HttpURLConnection性能差、TLS 版本旧、不支持连接池复用。你想换 OkHttp 引擎可以但得自己写OkHttpClientEngine还要处理OkHttpClient的线程模型、CookieJar、Interceptor 注入——这些本该由 Android 工程统一管理的能力全被 Ktor 封装层吃掉了。iOS 端无法对接 URLSessionConfiguration比如你需要配置timeoutIntervalForRequest 15Ktor 的HttpRequestBuilder只暴露timeout一个字段底层却把timeoutIntervalForResource和timeoutIntervalForRequest混为一谈导致 iOS 上长文件上传超时逻辑错乱。调试黑盒化Ktor 的Loggingplugin 只能打印字符串日志没法像 OkHttp 的HttpLoggingInterceptor那样直接看到 Request Body 的 JSON 格式、Response 的 gzip 解压后原始字节、甚至 TLS 握手的 cipher suite。线上排查 504 错误时你只能靠猜。提示Ktor 不是不好而是它定位是“跨平台 HTTP 客户端框架”不是“Android/iOS 原生网络能力的桥接器”。当你需要深度控制底层行为时它的抽象反而成了障碍。2.2 我们最终采用的三层架构Platform → Common → Business我们放弃了“一套代码跑三端”的理想主义转而采用更务实的分层策略┌─────────────────────────────────────────────────────┐ │ Business Layer (Common) │ │ • 定义 Request/Response 数据模型Serializable │ │ • 定义 NetworkResultT 封装 success/error │ │ • 定义 ApiService 接口suspend fun getUser() │ └─────────────────────────────────────────────────────┘ ↑ ↓ 纯 Kotlin 接口无实现 ┌─────────────────────────────────────────────────────┐ │ Common Abstraction Layer │ │ • HttpClientInterface定义 send()、cancel() │ │ • HttpRequest/HttpResponse 数据类不含平台类型 │ │ • HttpConfig超时、Header 默认值、Base URL │ └─────────────────────────────────────────────────────┘ ↑ ↓ 接口数据类无平台依赖 ┌─────────────────────────────────────────────────────┐ │ Platform Implementation (Android/iOS) │ │ • AndroidHttpClientImpl封装 OkHttp 实例 │ │ • iOSHttpClientImpl封装 URLSession 实例 │ │ • 各自注入 Context/UIApplication/NetworkMonitor │ └─────────────────────────────────────────────────────┘这个设计的核心逻辑是Common 层只做协议定义和业务编排Platform 层负责能力落地和平台适配。好处非常明显Android 团队可以继续用熟悉的 OkHttp Interceptor ConnectionPool CookieJar所有监控、埋点、降级开关都无缝接入iOS 团队用 URLSession delegate background task不影响现有网络监控 SDKCommon 层的ApiService可以被 ViewModel 直接调用协程作用域、异常处理、Loading 状态全部统一最关键的是当 OkHttp 升级到 4.12你只需要改 Android 实现Common 层和 iOS 实现完全不动——这才是 KMP 在网络层真正的价值解耦升级成本而非消灭平台差异。2.3 为什么不用 Retrofit MultiplatformRetrofit 官方至今未提供 KMP 支持2024 年 6 月状态社区有multiplatform-rxjava或kmp-retrofit等第三方库但它们本质是“把 Retrofit 的注解解析逻辑搬到 Common 层”底层仍需 Platform 实现CallT。我们试过kmp-retrofit问题在于它强制你用GET(user/{id})这种字符串拼接而 Android 原生 Retrofit 支持Path(id) Int类型安全校验KMP 版本丢失了这一层保护Headers无法动态注入比如你要根据用户登录态自动加Authorization: Bearer xxxAndroid 端用 Interceptor 很自然KMP 版本得在每个 API 方法里手动传 Map违背单一职责最致命的是它把ConverterGson/Moshi也搬到 Common 层但 Gson 的SerializedName在 iOS 上不生效Moshi 的JsonClass(generateAdapter true)又要求 KMM 编译器插件版本兼容性极差。所以我们选择绕过 Retrofit用更底层、更可控的HttpClientInterface自建抽象——牺牲一点开发速度换来长期维护的确定性。3. 核心细节解析Android 实现层的 7 个关键决策点3.1 OkHttp 实例的单例管理与生命周期绑定Android 端AndroidHttpClientImpl的核心是 OkHttp 实例。我们没用object Singleton简单包裹而是做了三层管控Application Scope 初始化在Application.onCreate()中创建OkHttpClient.Builder()配置全局参数val client OkHttpClient.Builder() .connectTimeout(15, TimeUnit.SECONDS) .readTimeout(30, TimeUnit.SECONDS) .writeTimeout(30, TimeUnit.SECONDS) .cookieJar(WebViewCookieJar()) // 复用 WebView Cookie .addInterceptor(HttpLoggingInterceptor().apply { level HttpLoggingInterceptor.Level.BODY }) .build()注意HttpLoggingInterceptor必须在 debug buildType 下才启用否则 release 包会因反射加载日志类导致 ProGuard 混淆失败。我们用BuildConfig.DEBUG控制而不是if (BuildConfig.DEBUG)—— 后者在 Kotlin Multiplatform 中不可用必须通过expect/actual机制桥接。Activity/Fragment Scope 绑定AndroidHttpClientImpl不持有OkHttpClient而是通过构造函数注入CoroutineScope所有请求都挂在这个 scope 下。当 Activity 销毁时scope.cancel() 自动取消所有未完成请求——这比 OkHttp 的call.cancel()更彻底避免内存泄漏。ConnectionPool 复用策略OkHttp 默认maxIdleConnections5但我们发现某些低端机如 Redmi Note 9在弱网下频繁新建连接导致SocketTimeoutException。实测将maxIdleConnections设为3keepAliveDuration30, TimeUnit.SECONDS配合ConnectionSpec.RESTRICTED_TLS整体连接成功率提升 12%。3.2 Request Body 的序列化为什么不用 kotlinx.serialization 直接 encodekotlinx.serialization确实支持encodeToString()但直接用于网络请求 Body 有两大隐患JSON 格式不一致Android 端用 Gson 时默认serializeNulls false而 kotlinx.serialization 默认encodeDefaults false但SerialName和Transient的行为不完全对齐。比如一个 DTOSerializable data class User( val id: Long, SerialName(user_name) val userName: String, val avatar: String? null )当avatar null时Gson 序列化结果是{id:1,user_name:jack}而 kotlinx.serialization 是{id:1,user_name:jack,avatar:null}—— 后端如果严格校验字段就会 400。性能损耗encodeToString()生成的是完整 StringOkHttp 发送时还得转成RequestBody.create(MediaType.parse(application/json), string)多一次 UTF-8 编码。我们改用ByteArray直接输出val jsonBytes Json.encodeToByteArray(User.serializer(), user) val body RequestBody.create(MediaType.parse(application/json), jsonBytes)这样既保证格式与 Gson 一致通过Json { encodeDefaults false; explicitNulls false }配置又减少一次字符串拷贝实测大对象10KB序列化耗时降低 35%。3.3 Response 解析如何让 Common 层拿到类型安全的 T而不暴露平台类型Common 层的NetworkResultT定义如下sealed interface NetworkResultT { data class SuccessT(val data: T) : NetworkResultT data class Error(val code: Int, val message: String, val rawResponse: String?) : NetworkResultNothing }Android 实现层不能直接return NetworkResult.Success(user)因为user是 Android 平台的User类含SerializedName注解而 Common 层期望的是Serializable的User。我们的解法是在 Android 实现层做一次“平台到 Common”的映射// Android 端 DTOGson 注解 data class AndroidUser( SerializedName(id) val id: Long, SerializedName(user_name) val userName: String, SerializedName(avatar) val avatar: String? ) // Common 层 DTOSerializable 注解 Serializable data class User( val id: Long, SerialName(user_name) val userName: String, val avatar: String? null ) // 映射函数Android 实现 private fun AndroidUser.toCommon(): User User(id, userName, avatar)这个映射看似冗余但它带来了关键收益Common 层完全不知道 Gson 的存在所有序列化逻辑由kotlinx.serialization统一管理当后端字段变更时只需改 Common 层User和 Android 层AndroidUser的映射iOS 端同理无需动业务逻辑单元测试可以 mockAndroidUser验证映射逻辑覆盖率 100%。3.4 Header 动态注入登录态、设备信息、TraceID 的统一管理Common 层ApiService不该知道AuthorizationHeader 怎么来但 Android 端必须能动态注入。我们没用 OkHttp 的Interceptor全局加而是设计了一个HeaderProvider接口interface HeaderProvider { fun provideHeaders(): MapString, String } // Android 实现 class AndroidHeaderProvider( private val authManager: AuthManager, private val deviceInfo: DeviceInfo ) : HeaderProvider { override fun provideHeaders(): MapString, String mapOf( Authorization to Bearer ${authManager.token}, X-Device-ID to deviceInfo.id, X-Trace-ID to UUID.randomUUID().toString() ) }AndroidHttpClientImpl在构建Request.Builder时调用headerProvider.provideHeaders()注入。这样做的好处是AuthManager可以是LiveData或StateFlowtoken 更新时自动生效无需重启请求DeviceInfo可以从Build类或TelephonyManager获取不同厂商定制化逻辑隔离在 Android 层测试时可注入FakeHeaderProvider返回固定 token避免测试环境鉴权失败。3.5 错误分类与重试策略不是所有 500 都该重试KMP 网络层必须定义清晰的错误边界。我们把错误分为四类错误类型触发条件Common 层处理Android 实现NetworkErrorIOExceptionDNS failed, timeout显示“网络不可用”引导用户检查 Wi-FiOkHttp 的call.execute()抛出IOExceptionHttpErrorHTTP status 400 600解析errorBody显示具体提示response.code()判断ParseErrorJSON 解析失败字段缺失、类型错误记录崩溃日志降级返回空数据try { Json.decodeFromByteArray(...) } catch (e: SerializationException)BusinessErrorHTTP 200 但code ! 0后端自定义错误码根据code跳转对应页面如 1001登录过期从response.body.string()解析通用 error 结构重试策略按类型差异化NetworkError最多重试 2 次间隔 1s/2s指数退避HttpError仅对 502/503/504 重试其他 4xx 直接上报ParseError不重试记录CrashlyticsBusinessError不重试交由业务逻辑处理。这个策略在 vivo 健康 App 灰度期间验证重试使弱网下单成功率从 78% 提升至 92%但盲目重试 401 导致 token 刷新风暴CPU 占用飙升 40%所以必须精准分类。3.6 文件上传multipart/form-data 的 KMP 兼容写法文件上传是 KMP 网络层最易翻车的场景。Common 层不能用FileiOS 没有java.io.File也不能用UriAndroid 的content://和 iOS 的file://路径规则不同。我们的方案是Common 层定义UploadPart接口Platform 层各自实现// Common interface UploadPart { val name: String val filename: String val contentType: String fun readBytes(): ByteArray } // Android 实现 class AndroidUploadPart( private val uri: Uri, private val contentResolver: ContentResolver ) : UploadPart { override val name file override val filename getFileName(uri) override val contentType contentResolver.getType(uri) ?: application/octet-stream override fun readBytes(): ByteArray { return contentResolver.openInputStream(uri)?.use { it.readBytes() } ?: byteArrayOf() } }这样Common 层ApiService.uploadAvatar(UploadPart)调用时Android 传AndroidUploadPartiOS 传IOSUploadPart各自处理路径解析和字节读取Common 层只关心readBytes()结果——既规避了平台类型又保证了大文件10MB上传时内存可控readBytes()可改为流式读取。3.7 TLS 配置与证书固定Certificate Pinning安全合规要求必须做证书固定。Ktor 的HttpsRedirect不支持 pinningOkHttp 原生支持但 KMP 层需要透出配置入口。我们在HttpConfig中增加data class HttpConfig( val baseUrl: String, val timeout: TimeoutConfig, val certificatePins: ListCertificatePin? null ) data class CertificatePin( val hostname: String, val sha256Hashes: ListString )Android 实现层将certificatePins转为 OkHttp 的CertificatePinnerval pinner CertificatePinner.Builder().apply { config.certificatePins?.forEach { pin - pin.sha256Hashes.forEach { hash - add(pin.hostname, sha256/$hash) } } }.build() val client OkHttpClient.Builder() .certificatePinner(pinner) ...实测中发现某银行合作方证书更新后SHA256 Hash 变更我们只需更新HttpConfig.certificatePins无需发版——因为配置走远程下发ABTest 配置中心热修复 3 小时内生效。4. 实操过程从零搭建 AndroidKMP 网络层的 12 步完整流程4.1 环境准备Android Studio 与 KMP 插件版本锁定当前2024 年中最稳的组合是Android StudioIguana | 2023.2.1 Patch 2不要用 JellyfishKMP 插件兼容性差Gradle Plugin8.4com.android.tools.build:gradle:8.4.0Kotlin Plugin1.9.20org.jetbrains.kotlin:kotlin-gradle-plugin:1.9.20KMM Plugin0.9.0org.jetbrains.kotlin.multiplatform:0.9.0注意kotlin-multiplatform插件 0.9.0 修复了expect/actual在debugbuildType 下无法识别的问题这是早期 KMP 网络层调试失败的主因。安装后重启 AS确认File Project Structure SDK Location中 Android SDK 路径正确且sdk/platforms/android-34存在。4.2 创建 KMP 模块命名规范与目录结构在项目根目录执行./gradlew createKmmModule --name network-core --package com.example.network生成后手动调整目录结构为标准 KMP 模式network-core/ ├── src/ │ ├── commonMain/ # Common 层Serializable, interfaces │ │ ├── kotlin/ │ │ │ ├── model/ │ │ │ │ └── User.kt │ │ │ ├── api/ │ │ │ │ └── ApiService.kt │ │ │ └── http/ │ │ │ ├── HttpClientInterface.kt │ │ │ └── NetworkResult.kt │ ├── androidMain/ # Android 实现OkHttp, Context │ │ └── kotlin/ │ │ └── http/ │ │ └── AndroidHttpClientImpl.kt │ └── iosMain/ # iOS 实现URLSession, UIApplication │ └── kotlin/ │ └── http/ │ └── IOSHttpClientImpl.kt关键点commonMain里绝对不能出现android.*或java.*包名否则 KMP 编译器报错。androidMain和iosMain是隔离的互不引用。4.3 配置 build.gradle.kts依赖与源集映射network-core/build.gradle.kts核心配置plugins { kotlin(multiplatform) id(com.android.library) } kotlin { androidTarget { publishAllLibraryVariants() } iosX64() iosArm64() iosSimulatorArm64() sourceSets { val commonMain by getting { dependencies { implementation(org.jetbrains.kotlinx:kotlinx-serialization-json:1.6.3) implementation(org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.3) } } val androidMain by getting { dependencies { implementation(com.squareup.okhttp3:okhttp:4.12.5) implementation(com.squareup.okhttp3:logging-interceptor:4.12.5) // 注意这里不加 GsonCommon 层用 kotlinx.serialization } } val iosMain by getting { dependencies { implementation(org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.3) } } } } android { namespace com.example.network compileSdk 34 defaultConfig { minSdk 21 } }实操心得publishAllLibraryVariants()必须开启否则 Android 模块引用时找不到releasevariant。minSdk 21是 OkHttp 4.x 的最低要求低于此版本需降级 OkHttp 3.x但会丢失 HTTP/3 支持。4.4 实现 Common 层从 NetworkResult 到 ApiServicesrc/commonMain/kotlin/http/NetworkResult.ktimport kotlinx.serialization.Serializable Serializable sealed interface NetworkResultT { Serializable data class SuccessT(val data: T) : NetworkResultT Serializable data class Error( val code: Int, val message: String, val rawResponse: String? null ) : NetworkResultNothing }src/commonMain/kotlin/api/ApiService.ktimport kotlinx.coroutines.flow.Flow interface ApiService { suspend fun getUser(userId: Long): NetworkResultUser suspend fun uploadAvatar(part: UploadPart): NetworkResultUploadResult // 注意UploadPart 是 expect/actual 定义此处只声明接口 }src/commonMain/kotlin/http/HttpClientInterface.ktimport kotlinx.coroutines.CoroutineScope interface HttpClientInterface { suspend fun T send( request: HttpRequest, responseDeserializer: (ByteArray) - T ): NetworkResultT fun cancel(tag: String) }注意HttpRequest是 Common 层数据类包含method,url,headers,bodyByteArray不依赖任何平台类型。responseDeserializer是 lambda由调用方传入如::User.Companion.deserialize。4.5 Android 实现AndroidHttpClientImpl 的完整代码src/androidMain/kotlin/http/AndroidHttpClientImpl.ktimport android.content.Context import android.util.Log import kotlinx.coroutines.* import okhttp3.* import okhttp3.MediaType.Companion.toMediaType import okhttp3.RequestBody.Companion.toRequestBody import okio.Buffer import java.io.IOException import java.net.SocketTimeoutException import java.util.concurrent.TimeUnit class AndroidHttpClientImpl( private val client: OkHttpClient, private val context: Context, private val headerProvider: HeaderProvider, private val scope: CoroutineScope ) : HttpClientInterface { override suspend fun T send( request: HttpRequest, responseDeserializer: (ByteArray) - T ): NetworkResultT withContext(scope.coroutineContext) { try { val builder Request.Builder() .url(request.url) .method(request.method.name, buildRequestBody(request)) // 动态 Header headerProvider.provideHeaders().forEach { (key, value) - builder.header(key, value) } val call client.newCall(builder.build()) val response call.execute() if (response.isSuccessful) { val bytes response.body?.bytes() ?: byteArrayOf() NetworkResult.Success(responseDeserializer(bytes)) } else { val raw response.body?.string() ?: NetworkResult.Error(response.code, response.message, raw) } } catch (e: SocketTimeoutException) { NetworkResult.Error(-1, 请求超时, null) } catch (e: IOException) { NetworkResult.Error(-2, 网络连接失败, null) } catch (e: Exception) { Log.e(KMPNetwork, Unexpected error, e) NetworkResult.Error(-999, 未知错误, null) } } override fun cancel(tag: String) { // OkHttp 不支持 tag cancel我们用 Call.cancel() // 实际项目中可维护 call map按 tag cancel } private fun buildRequestBody(request: HttpRequest): RequestBody? { return request.body?.let { body - body.toRequestBody(application/json.toMediaType()) } } }关键细节withContext(scope.coroutineContext)确保请求在指定 scope 下执行response.body?.bytes()是 OkHttp 的阻塞调用但 KMP 要求 suspend 函数所以必须包在withContext(Dispatchers.IO)—— 但我们已在构造时传入scope其 dispatcher 应为IO故省略显式 dispatcher。4.6 依赖注入在 Android App 中初始化并使用app/src/main/java/com/example/MyApplication.ktclass MyApplication : Application() { lateinit var networkModule: NetworkModule override fun onCreate() { super.onCreate() networkModule NetworkModule(this) } } class NetworkModule(private val context: Context) { private val okHttpClient OkHttpClient.Builder() .connectTimeout(15, TimeUnit.SECONDS) .readTimeout(30, TimeUnit.SECONDS) .build() private val headerProvider AndroidHeaderProvider( authManager AuthManager(), deviceInfo DeviceInfo(context) ) val apiService: ApiService object : ApiService { private val httpClient AndroidHttpClientImpl( client okHttpClient, context context, headerProvider headerProvider, scope CoroutineScope(Dispatchers.IO SupervisorJob()) ) override suspend fun getUser(userId: Long): NetworkResultUser { val request HttpRequest( method HttpMethod.GET, url https://api.example.com/user/$userId, headers emptyMap(), body null ) return httpClient.send(request) { bytes - Json.decodeFromByteArray(User.serializer(), bytes) } } override suspend fun uploadAvatar(part: UploadPart): NetworkResultUploadResult { // 实现略类似 getUser TODO() } } }ViewModel中调用class UserViewModel : ViewModel() { private val apiService (application as MyApplication).networkModule.apiService fun loadUser(userId: Long) { viewModelScope.launch { val result apiService.getUser(userId) when (result) { is NetworkResult.Success - handleSuccess(result.data) is NetworkResult.Error - handleError(result) } } } }注意viewModelScope是CoroutineScope但AndroidHttpClientImpl构造时传入的是Dispatchers.IO SupervisorJob()两者 scope 不同。我们要求AndroidHttpClientImpl的 scope 生命周期长于 ViewModel所以用SupervisorJob()避免 ViewModel 销毁时 cancel 掉所有请求——这符合“请求应独立于 UI 生命周期”的设计原则。4.7 调试技巧如何在 Android Studio 中查看 KMP 网络请求KMP 网络层调试最难的是“看不见请求”。我们用三招打通OkHttp Logging Interceptor Logcat 过滤在OkHttpClient.Builder()中添加.addInterceptor(HttpLoggingInterceptor().apply { level HttpLoggingInterceptor.Level.BODY // 关键设置 logger让日志输出到 Logcat logger object : HttpLoggingInterceptor.Logger { override fun log(message: String) { Log.d(KMP-HTTP, message) } } })然后在 Android Studio Logcat 中过滤KMP-HTTP就能看到完整 Request/Response。Stetho 集成仅 debug添加依赖com.facebook.stetho:stetho-okhttp3:1.6.0在 debug build 中初始化if (BuildConfig.DEBUG) { Stetho.initializeWithDefaults(context) val client OkHttpClient.Builder() .addNetworkInterceptor(StethoInterceptor()) ... }Chrome 访问chrome://inspect就能看到 KMP 请求的 timeline、Headers、Preview。断点调试 Common 层在ApiService.getUser()方法上打断点AS 会自动跳转到AndroidHttpClientImpl.send()—— 这要求network-core模块的commonMain和androidMain都被 AS 正确索引。若断点灰色检查File Project Structure Modules中network-core的Sources是否包含src/commonMain/kotlin和src/androidMain/kotlin。4.8 ProGuard 混淆配置防止 kotlinx.serialization 失效app/proguard-rules.pro必须添加# kotlinx.serialization -keepclassmembers class kotlinx.serialization.json.Json { *; } -keepclassmembers class com.example.network.** { kotlinx.serialization.Serializable public *; } -keepclassmembers class com.example.network.model.** { public *; } -keep class kotlinx.serialization.** { *; } -dontwarn kotlinx.serialization.**实测教训漏掉-keepclassmembers会导致Json.decodeFromByteArray()抛SerializationException: Class User is not registered for polymorphic serialization因为 ProGuard 移除了Serializable注解的反射信息。4.9 单元测试用 MockWebServer 验证 Android 实现src/androidTest/kotlin/http/AndroidHttpClientImplTest.ktRunWith(AndroidJUnit4::class) class AndroidHttpClientImplTest { private lateinit var server: MockWebServer private lateinit var client: AndroidHttpClientImpl Before fun setUp() { server MockWebServer() server.start() val okHttpClient OkHttpClient.Builder() .addInterceptor(HttpLoggingInterceptor().apply { level HttpLoggingInterceptor.Level.NONE }) .build() client AndroidHttpClientImpl( client okHttpClient, context InstrumentationRegistry.getInstrumentation().targetContext, headerProvider FakeHeaderProvider(), scope CoroutineScope(Dispatchers.Unconfined) ) } After fun tearDown() { server.shutdown() } Test fun getUser returns success() runBlocking { // Given server.enqueue(MockResponse().setBody({id:1,user_name:jack})) // When val result client.send( HttpRequest( method HttpMethod.GET, url server.url(/user/1).toString(), headers emptyMap(), body null ), ::User.Companion.deserialize ) // Then assertTrue(result is NetworkResult.Success) assertEquals(1L, result.data.id) assertEquals(jack, result.data.userName) } }注意runBlocking在 AndroidTest 中安全因为Dispatchers.Unconfined不切换线程。MockWebServer是 OkHttp 官方测试库比WireMock更轻量启动快、无额外依赖。4.10 性能压测对比 KMP 网络层与传统 Retrofit我们在 vivo X100 上用Android Profiler对比指标Retrofit OkHttpKMP 网络层差异首屏 API 平均耗时287ms291ms1.4%可忽略内存占用100 次请求12.3MB12.5MB0.2MBAPK 增量大小-1.2MBnetwork-core.aar主要来自 kotlinx.serialization方法数Dex18,42018,650230结论KMP 网络层性能损耗在 2% 以内APK 增量可控1.2MB 占 base 包 3%方法数增加 230 个远低于 Multidex 阈值65536。真正的收益不在性能而在协作效率iOS 团队用同一套UserDTO前端用