KMP项目集成Jetpack ViewModel时Compose Desktop编译报错：Main dispatcher缺失

API 探路者

2026-6-23

KMP集成Jetpack ViewModel桌面端编译失败修复

问题描述

在KMP项目中配置Jetpack ViewModel结合Koin使用后，桌面应用编译抛出异常：

Exception in thread "AWT-EventQueue-0" 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'

原因

Jetpack ViewModel的viewModelScope依赖Main协程调度器，但桌面JVM环境默认没有内置该调度器的实现，需要手动添加对应平台的协程依赖。

解决方案

1. 更新`libs.versions.toml`配置

首先添加kotlinx-coroutines版本（需与项目中kotlinx-coroutines-core版本保持一致），并引入桌面端的Main dispatcher依赖：

[versions]
# 新增：确保版本与kotlinx-coroutines-core一致
kotlinxCoroutines = "1.7.3"
androidxLifecycle = "2.8.0"
koin-compose = "1.2.0-Beta4"
navigation-compose = "2.8.0-alpha02"

[libraries]
androidx-lifecycle-viewmodel = { module = "androidx.lifecycle:lifecycle-viewmodel", version.ref = "androidxLifecycle" }
koin-compose-viewmodel = { module = "io.insert-koin:koin-compose-viewmodel", version.ref = "koin-compose" }
navigation-compose = { module = "org.jetbrains.androidx.navigation:navigation-compose", version.ref = "navigation-compose" }
# 新增：桌面Swing应用的Main dispatcher依赖
kotlinx-coroutines-swing = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-swing", version.ref = "kotlinxCoroutines" }

2. 在桌面模块引入依赖

在桌面端的build.gradle.kts中，将上述依赖添加到jvmMain源码集：

sourceSets {
    val jvmMain by getting {
        dependencies {
            // 其他依赖...
            implementation(libs.kotlinx.coroutines.swing)
        }
    }
}