...
Eroare Kotlin · Corutine

java.lang.IllegalStateException: Trying to call 'getOrThrow' on a failed channel result: Failed

Pe scurt

Ai apelat getOrThrow() pe rezultatul lui tryReceive() sau trySend(), iar operația nu a reușit: canalul era gol (Failed) sau închis (Closed). tryReceive nu așteaptă. Folosește getOrNull() și tratează null, sau receive() într-o corutină, care așteaptă o valoare.

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

Ce înseamnă

trySend și tryReceive sunt variantele fără suspendare ale lui send și receive: încearcă imediat și întorc un ChannelResult, care poate fi succes, eșec (Failed: canal plin la trimitere, gol la citire) sau închis (Closed(cauza)).

getOrThrow() scoate valoarea dintr-un rezultat reușit; pe un rezultat nereușit aruncă IllegalStateException cu mesajul acesta, urmat de starea rezultatului: Failed (canalul era gol) sau Closed(null) (canalul era închis și golit). Dacă închiderea a avut o cauză, se aruncă acea cauză.

Apare des când cineva folosește tryReceive() crezând că așteaptă o valoare, ca receive(), sau citește dintr-un canal înainte ca producătorul să fi trimis ceva.

De ce apare: cauzele frecvente

1tryReceive pe un canal gol

Greșit
KOTLIN
import kotlinx.coroutines.channels.*

fun main() {
    val c = Channel<Int>(Channel.UNLIMITED)
    println(c.tryReceive().getOrThrow())
}
Corect
KOTLIN
import kotlinx.coroutines.channels.*

fun main() {
    val c = Channel<Int>(Channel.UNLIMITED)
    println(c.tryReceive().getOrNull() ?: "nimic de procesat")
}

getOrNull() întoarce null când nu există valoare, fără excepție.

2Ai vrut să aștepți valoarea

Greșit
KOTLIN
import kotlinx.coroutines.*
import kotlinx.coroutines.channels.*

fun main() = runBlocking {
    val c = Channel<Int>()
    launch { delay(10); c.send(5) }
    println(c.tryReceive().getOrThrow())
}
Corect
KOTLIN
import kotlinx.coroutines.*
import kotlinx.coroutines.channels.*

fun main() = runBlocking {
    val c = Channel<Int>()
    launch { delay(10); c.send(5) }
    println(c.receive())
}

receive() suspendă corutina până sosește valoarea.

Repară tu

Repară eroarea, direct în pagină

Programul de mai jos verifică, fără să aștepte, dacă au sosit notificări noi într-un canal. Nu a sosit niciuna, iar programul se oprește cu IllegalStateException: Trying to call 'getOrThrow' on a failed channel result: Failed. Repară citirea ca, la canal gol, să afișeze Nicio notificare noua.

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

fun main() {
    val notificari = Channel<String>(Channel.UNLIMITED)
    val urmatoarea = notificari.tryReceive().getOrThrow()
    println(urmatoarea)
}
După reparație, programul afișează
Nicio notificare noua
Indiciu

Folosește getOrNull() și operatorul ?: pentru mesajul implicit.

Alte forme ale mesajului

  • Exception in thread "main" java.lang.IllegalStateException: Trying to call 'getOrThrow' on a failed channel result: Failed
  • java.lang.IllegalStateException: Trying to call 'getOrThrow' on a failed channel result: Closed(null)
  • java.lang.IllegalStateException: Trying to call 'getOrThrow' on a failed channel result

Cum o eviți pe viitor

Folosește tryReceive/trySend doar când chiar nu vrei să aștepți (în cod fără corutine, în callback-uri) și tratează explicit rezultatul: getOrNull(), isSuccess, isClosed, onSuccess { } / onFailure { }. În corutine, preferă receive(), send() și for (x in canal), care așteaptă și se opresc corect la închidere.

Întrebări frecvente

Ce înseamnă Failed față de Closed(null)?

Failed: canalul e deschis, dar momentan gol (sau plin, la trimitere); poate reuși mai târziu. Closed(null): canalul e închis normal și nu va mai avea valori.

De ce trySend pe un canal fără buffer eșuează?

Un Channel() fără capacitate predă valoarea doar dacă un consumator așteaptă chiar atunci. Altfel trySend dă Failed. Pentru trimiteri din cod obișnuit, dă canalului un buffer (Channel(Channel.UNLIMITED) sau o capacitate).

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.