...
Eroare Kotlin · Corutine

java.lang.IllegalStateException: Module with the Main dispatcher is missing. Add dependency providing the Main dispatcher, e.g. 'kotlinx-coroutines-android'

Pe scurt

Codul folosește Dispatchers.Main, dar rulează într-un loc fără fir principal de UI: un program JVM simplu, un test unitar sau un server. În Android adaugă kotlinx-coroutines-android; în teste înlocuiește Main cu Dispatchers.setMain(...); în cod obișnuit folosește Dispatchers.Default sau IO.

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

Ce înseamnă

Dispatchers.Main înseamnă „rulează pe firul principal al interfeței grafice”. Ce fir e acela depinde de platformă, așa că implementarea vine dintr-un modul separat: kotlinx-coroutines-android (Android), kotlinx-coroutines-swing sau kotlinx-coroutines-javafx (desktop). Biblioteca de bază (kotlinx-coroutines-core) nu are niciun fir de UI. Când codul cere Dispatchers.Main și nu găsește un astfel de modul, aruncă IllegalStateException cu mesajul acesta (și uneori cu Dispatchers.Main[missing] în stivă).

Cel mai des apare în testele unitare pentru ViewModel-uri Android: testele rulează pe JVM, fără Android, iar viewModelScope folosește Dispatchers.Main. Soluția acolo este Dispatchers.setMain(StandardTestDispatcher()) din kotlinx-coroutines-test. Mai apare în programe consolă sau pe server, unde Main nu are sens.

De ce apare: cauzele frecvente

1Main într-un program consolă

Greșit
KOTLIN
import kotlinx.coroutines.*

fun main() = runBlocking {
    withContext(Dispatchers.Main) { println("actualizez") }
}
Corect
KOTLIN
import kotlinx.coroutines.*

fun main() = runBlocking {
    withContext(Dispatchers.Default) { println("actualizez") }
}

Fără interfață grafică, folosești Default (calcule) sau IO (fișiere, rețea).

2Test unitar pentru un ViewModel

Greșit
KOTLIN
@Test
fun incarca() = runTest {
    val vm = ProduseViewModel()
    vm.incarca()
}
Corect
KOTLIN
@Before
fun setUp() {
    Dispatchers.setMain(StandardTestDispatcher())
}

@After
fun tearDown() {
    Dispatchers.resetMain()
}

setMain din kotlinx-coroutines-test înlocuiește dispatcher-ul Main cu unul de test, fără fir Android.

Repară tu

Repară eroarea, direct în pagină

Programul de mai jos (un program consolă, fără interfață grafică) a copiat dintr-o aplicație Android un scope pe Dispatchers.Main și se oprește cu IllegalStateException: Module with the Main dispatcher is missing. Repară-l folosind un dispatcher disponibil pe JVM, ca să afișeze Rezultat: 55.

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

fun main() {
    val scope = CoroutineScope(Dispatchers.Main)
    val job = scope.launch {
        println("Rezultat: ${(1..10).sum()}")
    }
    runBlocking { job.join() }
}
După reparație, programul afișează
Rezultat: 55
Indiciu

Pentru un calcul într-un program consolă, folosește Dispatchers.Default.

Alte forme ale mesajului

  • Exception in thread "main" java.lang.IllegalStateException: Module with the Main dispatcher is missing. Add dependency providing the Main dispatcher, e.g. 'kotlinx-coroutines-android' and ensure it has the same version as 'kotlinx-coroutines-core'
  • java.lang.IllegalStateException: Module with the Main dispatcher had failed to initialize. For tests Dispatchers.setMain from kotlinx-coroutines-test module can be used

Cum o eviți pe viitor

Nu scrie Dispatchers.Main direct în clase pe care vrei să le testezi: primește dispatcher-ele prin constructor (class Repo(private val io: CoroutineDispatcher = Dispatchers.IO)), ca testele să poată da altele. În modulele de logică (fără UI), folosește doar Default și IO. În Android, asigură-te că kotlinx-coroutines-android are aceeași versiune ca kotlinx-coroutines-core.

Întrebări frecvente

Am adăugat kotlinx-coroutines-android și tot primesc eroarea în teste. De ce?

Testele unitare rulează pe JVM, fără sistemul Android, deci nici acel modul nu poate crea firul principal. În teste folosești Dispatchers.setMain din kotlinx-coroutines-test.

Ce dispatcher aleg în loc de Main?

Dispatchers.Default pentru calcule pe CPU, Dispatchers.IO pentru operații care așteaptă (fișiere, rețea, baze de date).

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.