...
Eroare Kotlin · Corutine

kotlinx.coroutines.JobCancellationException: DeferredCoroutine was cancelled

Pe scurt

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

Greșit
KOTLIN
import kotlinx.coroutines.*

fun main() = runBlocking {
    val d = async { delay(100); 42 }
    d.cancel()
    println(d.await())
}
Corect
KOTLIN
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ă

Greșit
KOTLIN
import kotlinx.coroutines.*

fun main() = runBlocking {
    val job = launch {
        try { delay(1000) } catch (e: Exception) { println("Eroare: $e") }
    }
    delay(10)
    job.cancel()
}
Corect
KOTLIN
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ă tu

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.

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

fun main() = runBlocking {
    val raport = async {
        delay(500)
        "raport.pdf"
    }
    raport.cancel()
    println("Descarcat: ${raport.await()}")
}
După reparație, programul afișează
Descarcare anulata
Indiciu

Înainte de await(), verifică raport.isCancelled.

Alte forme ale mesajului

  • Exception in thread "main" kotlinx.coroutines.JobCancellationException: DeferredCoroutine was cancelled; job=DeferredCoroutine{Cancelled}@6bc168e5
  • kotlinx.coroutines.JobCancellationException: StandaloneCoroutine was cancelled
  • kotlinx.coroutines.JobCancellationException: Parent job is Cancelling
  • kotlinx.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

← 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.