kotlinx.coroutines.TimeoutCancellationException: Timed out waiting for 100 ms
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 întoarcenullla 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
import kotlinx.coroutines.*
fun main() = runBlocking {
val r = withTimeout(100) {
delay(300)
"date"
}
println(r)
}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
import kotlinx.coroutines.*
fun main() = runBlocking {
withTimeout(50) { delay(200) }
println("Continuam")
}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ă 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.
import kotlinx.coroutines.*
suspend fun cursDeLaServer(): Double {
delay(250)
return 4.98
}
fun main() = runBlocking {
val curs = withTimeout(100) { cursDeLaServer() }
println("Curs EUR: $curs")
}Curs EUR: 4.97
Indiciu
Folosește withTimeoutOrNull și operatorul ?: cu valoarea salvată.
Reparația
import kotlinx.coroutines.*
suspend fun cursDeLaServer(): Double {
delay(250)
return 4.98
}
fun main() = runBlocking {
val curs = withTimeoutOrNull(100) { cursDeLaServer() } ?: 4.97
println("Curs EUR: $curs")
}De ce merge
Serverul simulat răspunde în 250 ms, iar limita este 100 ms. withTimeout anulează operația și aruncă TimeoutCancellationException, care oprea programul. withTimeoutOrNull face aceeași anulare, dar întoarce null, iar ?: 4.97 alege valoarea salvată. Așa, un server lent nu mai blochează aplicația.
Alte forme ale mesajului
Exception in thread "main" kotlinx.coroutines.TimeoutCancellationException: Timed out waiting for 100 mskotlinx.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
Suspend function 'suspend fun delay(timeMillis: Long): Unit' can only be called from a coroutine or another suspend function Apelezi o funcție suspend (delay, o funcție proprie marcată suspend) dintr-o funcție obișnuită. Funcțiile suspend pot fi apelate doar din corutine sau din alte funcții suspend. Marchează și funcția apelantă cu suspend, sau pornește o corutină, de exemplu cu runBlocking { } în main. Unresolved reference 'runBlocking' Folosești runBlocking (sau launch, async, delay) fără importul bibliotecii de corutine. Adaugă sus în fișier import kotlinx.coroutines.* și, într-un proiect Gradle, dependența kotlinx-coroutines-core. launch și async cer în plus să fii într-un CoroutineScope. java.lang.IllegalArgumentException: Failed requirement. O verificare require(...) din cod a primit false: o funcție a fost apelată cu un argument invalid (o sumă negativă, o listă goală). Repară apelul ca să trimită date valide sau tratează cazul înainte de apel. Pune un mesaj în require ca eroarea să spună ce e greșit. Î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.
