Retrofit中Kotlin协程异常处理的常见误区与正确实践

在使用Retrofit进行网络请求时，许多开发者会遇到一个看似奇怪的现象：当使用Kotlin协程捕获异常时，总是得到kotlin.Unit类型的异常，而无法获取实际的网络异常信息。本文将深入分析这一现象的原因，并提供正确的异常处理方式。

问题现象分析

在Kotlin协程中，开发者通常会这样处理Retrofit的网络请求：

fun callApi() = viewModelScope.launch {
    try {
        val resp = apiService.getData()
    } catch (e: Exception) {
        Log.e(TAG, "callApi: ${e.printStackTrace()}")
    }
}

这段代码看似合理，但实际上存在一个关键问题：printStackTrace()方法的返回值是Unit类型（即Kotlin中的"无返回值"标记），而不是异常对象本身。因此，日志中只会输出kotlin.Unit，而不会显示实际的异常堆栈信息。

根本原因

这个问题与Retrofit本身无关，而是Kotlin语言特性和开发者对异常处理方法的误解共同导致的：

1. printStackTrace()是一个返回Unit的方法，它本身的作用是将堆栈信息打印到标准错误流，而不是返回字符串
2. 在字符串模板中直接使用${e.printStackTrace()}时，实际上插入的是该方法的返回值Unit，而不是异常信息
3. 这种用法掩盖了真实的网络异常，如UnknownHostException、SocketTimeoutException等

正确的异常处理方法

方法一：使用stackTraceToString

Kotlin为异常对象提供了stackTraceToString()方法，可以直接获取异常的完整堆栈信息字符串：

catch (e: Exception) {
    Log.e(TAG, "callApi: ${e.stackTraceToString()}")
}

方法二：分开打印

也可以将异常打印与日志记录分开进行：

catch (e: Exception) {
    e.printStackTrace()
    Log.e(TAG, "callApi failed", e)
}

方法三：处理特定异常

针对不同的网络异常，可以进行精细化处理：

catch (e: IOException) {
    // 处理网络IO异常
    Log.e(TAG, "Network error: ${e.message}")
} catch (e: HttpException) {
    // 处理HTTP错误响应
    Log.e(TAG, "HTTP error: ${e.code()}")
} catch (e: Exception) {
    // 处理其他异常
    Log.e(TAG, "Unexpected error", e)
}

最佳实践建议

1. 避免在字符串模板中直接使用printStackTrace()：这会导致异常信息丢失
2. 使用Kotlin提供的stackTraceToString()：这是获取完整异常信息的最简洁方式
3. 区分不同类型的网络异常：针对连接超时、主机不可达、HTTP错误等不同情况分别处理
4. 考虑使用Sealed Class封装结果：可以创建类似Result<T>的密封类来统一处理成功和失败情况

通过正确的异常处理方式，开发者可以准确获取网络请求过程中的各种错误信息，从而更好地调试和优化应用。