java.lang.IllegalStateException: Module with the Main dispatcher is missing. Add dependency providing the Main dispatcher, e.g. 'kotlinx-coroutines-android'
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ă
import kotlinx.coroutines.*
fun main() = runBlocking {
withContext(Dispatchers.Main) { println("actualizez") }
}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
@Test
fun incarca() = runTest {
val vm = ProduseViewModel()
vm.incarca()
}@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ă 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.
import kotlinx.coroutines.*
fun main() {
val scope = CoroutineScope(Dispatchers.Main)
val job = scope.launch {
println("Rezultat: ${(1..10).sum()}")
}
runBlocking { job.join() }
}Rezultat: 55
Indiciu
Pentru un calcul într-un program consolă, folosește Dispatchers.Default.
Reparația
import kotlinx.coroutines.*
fun main() {
val scope = CoroutineScope(Dispatchers.Default)
val job = scope.launch {
println("Rezultat: ${(1..10).sum()}")
}
runBlocking { job.join() }
}De ce merge
Dispatchers.Main are nevoie de un fir de interfață grafică, oferit de module ca kotlinx-coroutines-android. Un program JVM simplu nu are așa ceva, deci la launch dispatcher-ul lipsește și apare excepția. Dispatchers.Default folosește un grup de fire pentru calcule, disponibil peste tot; job.join() așteaptă terminarea, iar suma 1..10 dă 55.
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
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. 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. Î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.
