kotlinx.coroutines.JobCancellationException: DeferredCoroutine was cancelled
Ai așteptat (await, join) rezultatul unei corutine care fusese anulată, de tine sau de părintele ei. O corutină anulată nu mai are rezultat, așa că await aruncă excepția. Verifică isCancelled înainte, nu anula ce urmează să folosești, sau tratează CancellationException explicit.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Fiecare launch / async creează un Job. cancel() îl anulează: corutina se oprește la următorul punct de suspendare (delay, alt apel suspend). JobCancellationException este forma internă a lui CancellationException, iar textul spune ce s-a anulat: DeferredCoroutine was cancelled (un async), StandaloneCoroutine was cancelled (un launch), Parent job is Cancelling (s-a anulat părintele, de exemplu pentru că alt copil a eșuat).
În mod normal, anularea e silențioasă: o corutină anulată se oprește fără să afișeze nimic. Excepția devine vizibilă când chemi await() pe un Deferred anulat (nu există rezultat de întors) sau când o prinzi din greșeală și o afișezi (catch (e: Exception)).
În aplicațiile Android apare des la viewModelScope / lifecycleScope, când ecranul se închide și cererea în curs e anulată.
De ce apare: cauzele frecvente
1await după cancel
import kotlinx.coroutines.*
fun main() = runBlocking {
val d = async { delay(100); 42 }
d.cancel()
println(d.await())
}import kotlinx.coroutines.*
fun main() = runBlocking {
val d = async { delay(100); 42 }
d.cancel()
println(if (d.isCancelled) "anulat" else d.await().toString())
}Un Deferred anulat nu are valoare. Verifici starea și alegi ce afișezi.
2Anularea prinsă ca eroare obișnuită
import kotlinx.coroutines.*
fun main() = runBlocking {
val job = launch {
try { delay(1000) } catch (e: Exception) { println("Eroare: $e") }
}
delay(10)
job.cancel()
}import kotlinx.coroutines.*
fun main() = runBlocking {
val job = launch {
try { delay(1000) } catch (e: CancellationException) { println("Anulat"); throw e }
}
delay(10)
job.cancel()
}Anularea nu e o eroare. Dacă o prinzi, arunc-o mai departe (throw e), ca mecanismul de anulare să funcționeze corect.
Repară eroarea, direct în pagină
Programul de mai jos pornește descărcarea unui raport, utilizatorul o anulează, iar codul încearcă apoi să afișeze rezultatul și se oprește cu JobCancellationException: DeferredCoroutine was cancelled. Repară-l ca, dacă descărcarea a fost anulată, să afișeze Descarcare anulata.
import kotlinx.coroutines.*
fun main() = runBlocking {
val raport = async {
delay(500)
"raport.pdf"
}
raport.cancel()
println("Descarcat: ${raport.await()}")
}Descarcare anulata
Indiciu
Înainte de await(), verifică raport.isCancelled.
Reparația
import kotlinx.coroutines.*
fun main() = runBlocking {
val raport = async {
delay(500)
"raport.pdf"
}
raport.cancel()
if (raport.isCancelled) {
println("Descarcare anulata")
} else {
println("Descarcat: ${raport.await()}")
}
}De ce merge
raport.cancel() anulează corutina înainte să ajungă la rezultat, așa că await() nu are ce întoarce și aruncă JobCancellationException. isCancelled devine true imediat după cancel(), deci verificarea alege ramura cu mesajul pentru utilizator. Codul nu mai cere rezultatul unei operații care știe că a fost oprită.
Alte forme ale mesajului
Exception in thread "main" kotlinx.coroutines.JobCancellationException: DeferredCoroutine was cancelled; job=DeferredCoroutine{Cancelled}@6bc168e5kotlinx.coroutines.JobCancellationException: StandaloneCoroutine was cancelledkotlinx.coroutines.JobCancellationException: Parent job is Cancellingkotlinx.coroutines.JobCancellationException: Job was cancelled
Cum o eviți pe viitor
Nu prinde CancellationException (sau Exception în general) în corutine fără să o arunci mai departe. Când anulezi o operație, nu mai aștepta rezultatul ei: verifică isActive / isCancelled sau folosește withTimeoutOrNull pentru limite de timp. În Android, lasă viewModelScope să anuleze cererile și nu afișa utilizatorului mesaje pentru anulări.
Întrebări frecvente
Trebuie să afișez această excepție ca eroare?
De obicei nu. Anularea e un comportament normal (utilizatorul a ieșit de pe ecran, a apăsat „Renunță”). Log-urile și mesajele de eroare ar trebui să o ignore.
De ce mi s-a anulat corutina fără să chem cancel?
Probabil a eșuat altă corutină din același scope: într-un scope obișnuit, eșecul unui copil anulează părintele și toți frații lui (Parent job is Cancelling). supervisorScope evită asta.
Erori înrudite
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. 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 'await' on receiver of type 'Job' Ai pornit corutina cu launch, care întoarce un Job fără rezultat, și apoi ceri rezultatul cu await(). Dacă îți trebuie o valoare, pornește corutina cu async (întoarce Deferred<T>, care are await()). Dacă vrei doar să aștepți terminarea, folosește join(). Î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.
