withTimeout设置3秒后未按时抛出TimeoutCancellationException问题排查

最关键的原因：阻塞IO不响应协程取消 #

Kotlin的withTimeout是依靠协程的取消机制来触发超时的，但你使用的URL.readText()是Java提供的阻塞式IO方法——它完全不知道协程的存在，也不会响应协程发出的取消信号。

调用这个方法后，线程会被直接卡死，只能等待系统层面的网络超时（也就是你提到的约15秒）才会释放。这期间withTimeout的3秒计时虽然早已结束，但它根本无法打断这个阻塞操作，只能被动等待，所以超时异常才会延迟很久才抛出。

次要因素：协程调度被阻塞 #

如果你的协程运行在默认调度器（比如Dispatchers.Default），阻塞IO会占用调度器的线程，导致协程的取消逻辑无法及时执行，进一步拖慢了超时异常的触发速度。

放弃使用URL.readText()这类阻塞式方法，换成支持协程的非阻塞HTTP客户端，比如Ktor HttpClient或者带协程扩展的OkHttp。它们的请求方法都是挂起函数，能够响应协程的取消信号，withTimeout就能准时生效。

举个Ktor的示例代码：

import io.ktor.client.*
import io.ktor.client.call.*
import io.ktor.client.request.*
import kotlinx.coroutines.withTimeout
import java.io.IOException
import kotlinx.coroutines.TimeoutCancellationException

suspend fun main() {
    val client = HttpClient()
    try {
        withTimeout(3000) {
            val response = client.get("http://192.168.10.10/getData").body<String>()
            var x = 0
        }
    } catch (ex: IOException) {
        // 处理网络异常
    } catch (ex: TimeoutCancellationException) {
        // 处理3秒超时
    } finally {
        client.close()
    }
}

如果一定要使用原生URL类，可以把阻塞操作放到Dispatchers.IO中，但这种方式依然无法让它响应协程取消（手动中断线程的方案也不可靠），因此更推荐使用协程友好的HTTP客户端。

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