...
Eroare Kotlin · Corutine

kotlinx.coroutines.TimeoutCancellationException: Timed out waiting for 100 ms

Pe scurt

Codul din withTimeout(100) { ... } n-a terminat în 100 ms, așa că a fost anulat și s-a aruncat excepția. Mărește limita dacă e prea mică, folosește withTimeoutOrNull (care dă null în loc de excepție) sau prinde excepția și tratează cazul.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

withTimeout(timp) { ... } rulează blocul și îl anulează dacă depășește timpul dat (în milisecunde). La depășire aruncă kotlinx.coroutines.TimeoutCancellationException: Timed out waiting for 100 ms. Este o subclasă a lui CancellationException, deci face parte din mecanismul de anulare al corutinelor.

Când apare în main (în runBlocking), excepția oprește programul. Dacă se întâmplă într-un launch sau async, poate anula și corutina părinte.

Reparația depinde de ce vrei:

  • limita e prea strictă: mărește-o;
  • depășirea e un caz normal (serverul răspunde uneori greu): folosește withTimeoutOrNull, care întoarce null la depășire, și tratează rezultatul cu ?:;
  • vrei să reacționezi la timeout: try { withTimeout(...) { } } catch (e: TimeoutCancellationException) { ... }.

De ce apare: cauzele frecvente

1Operație mai lentă decât limita

Greșit
KOTLIN
import kotlinx.coroutines.*

fun main() = runBlocking {
    val r = withTimeout(100) {
        delay(300)
        "date"
    }
    println(r)
}
Corect
KOTLIN
import kotlinx.coroutines.*

fun main() = runBlocking {
    val r = withTimeoutOrNull(100) {
        delay(300)
        "date"
    }
    println(r ?: "timeout, folosim datele din cache")
}

withTimeoutOrNull transformă depășirea în null, tratat cu ?:.

2Timeout prins explicit

Greșit
KOTLIN
import kotlinx.coroutines.*

fun main() = runBlocking {
    withTimeout(50) { delay(200) }
    println("Continuam")
}
Corect
KOTLIN
import kotlinx.coroutines.*

fun main() = runBlocking {
    try {
        withTimeout(50) { delay(200) }
    } catch (e: TimeoutCancellationException) {
        println("Operatia a durat prea mult")
    }
    println("Continuam")
}

Cu try/catch, programul tratează depășirea și merge mai departe.

Repară tu

Repară eroarea, direct în pagină

Programul de mai jos cere cursul valutar de la un server lent și se oprește cu TimeoutCancellationException: Timed out waiting for 100 ms. Repară-l ca, la depășirea timpului, să folosească valoarea salvată 4.97, iar programul să afișeze Curs EUR: 4.97.

Codul care dă eroarea
KOTLIN
import kotlinx.coroutines.*

suspend fun cursDeLaServer(): Double {
    delay(250)
    return 4.98
}

fun main() = runBlocking {
    val curs = withTimeout(100) { cursDeLaServer() }
    println("Curs EUR: $curs")
}
După reparație, programul afișează
Curs EUR: 4.97
Indiciu

Folosește withTimeoutOrNull și operatorul ?: cu valoarea salvată.

Alte forme ale mesajului

  • Exception in thread "main" kotlinx.coroutines.TimeoutCancellationException: Timed out waiting for 100 ms
  • kotlinx.coroutines.TimeoutCancellationException: Timed out waiting for 5000 ms

Cum o eviți pe viitor

Pentru operațiile care pot dura (rețea, servicii externe), folosește withTimeoutOrNull și decide explicit ce se întâmplă la depășire: date din cache, un mesaj, o reîncercare. Alege limitele după măsurători reale, nu la întâmplare. Nu prinde CancellationException în general (de exemplu cu catch (e: Exception)) fără s-o arunci mai departe: strici anularea corutinelor.

Întrebări frecvente

Ce diferență e între withTimeout și withTimeoutOrNull?

La depășire, withTimeout aruncă TimeoutCancellationException, iar withTimeoutOrNull întoarce null. Al doilea e mai simplu când timeout-ul e un caz normal.

De ce nu se oprește blocul meu la timeout?

Anularea în corutine e cooperativă: codul se oprește doar în puncte de suspendare (delay, yield, alte funcții suspend) sau dacă verifici isActive. O buclă de calcul fără suspendări nu poate fi întreruptă.

Erori înrudite

← Toate erorile Kotlin

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Kotlin de la zero, cu exerciții la fiecare lecție

Curs Kotlin (Android): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.