KMM集成Room报错：Unresolved reference 'instantiateImpl'

我正在Kotlin Multiplatform（KMM）项目中集成Room组件，参考官方文档开发，但创建RoomDatabaseBuilder时，框架本该自动生成的instantiateImpl函数无法调用，提示错误：Unresolved reference 'instantiateImpl'。项目是用Compose Multiplatform向导创建的，相关代码及配置如下：

相关代码文件 #

root/composeApp/src/iosMain/kotlin/data/local/RoomDatabase.kt #

fun buildDatabase(): RoomDatabase.Builder<KwontDb> {
    val dbFilePath = NSHomeDirectory() + "/my_room.db"
    return Room.databaseBuilder<KwontDb>(
        name = dbFilePath,
        factory = {
            KwontDb::class.instantiateImpl() 
          // ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
          // Unresolved reference 'instantiateImpl'.
        }
    )
}

composeApp/build.gradle.kts #

import org.jetbrains.kotlin.gradle.ExperimentalKotlinGradlePluginApi
import org.jetbrains.kotlin.gradle.dsl.JvmTarget

plugins {
    alias(libs.plugins.kotlinMultiplatform)
    alias(libs.plugins.androidApplication)
    alias(libs.plugins.jetbrainsCompose)
    alias(libs.plugins.compose.compiler)
    alias(libs.plugins.ksp)
    alias(libs.plugins.room)
}

kotlin {
    task("testClasses")
    androidTarget {
        @OptIn(ExperimentalKotlinGradlePluginApi::class)
        compilerOptions {
            jvmTarget.set(JvmTarget.JVM_11)
        }
    }
    
    listOf(
        iosX64(),
        iosArm64(),
        iosSimulatorArm64()
    ).forEach { iosTarget ->
        iosTarget.binaries.framework {
            baseName = "ComposeApp"
            isStatic = true
        }
    }
    
    sourceSets {
        
        androidMain.dependencies {
            implementation(compose.preview)
            implementation(libs.androidx.activity.compose)
        }
        commonMain.dependencies {
            implementation(compose.runtime)
            implementation(compose.foundation)
            implementation(compose.material)
            implementation(compose.ui)
            implementation(compose.components.resources)
            implementation(compose.components.uiToolingPreview)
            implementation(libs.kotlinx.coroutines.core)
            implementation(libs.multiplatform.settings)

            // Room
            implementation(libs.androidx.room.runtime)
        }
    }

}

android {
    namespace = "dk.mikkelthygesen.kwontgame"
    compileSdk = libs.versions.android.compileSdk.get().toInt()

    sourceSets["main"].manifest.srcFile("src/androidMain/AndroidManifest.xml")
    sourceSets["main"].res.srcDirs("src/androidMain/res")
    sourceSets["main"].resources.srcDirs("src/commonMain/resources")

    defaultConfig {
        applicationId = "dk.mikkelthygesen.kwontgame"
        minSdk = libs.versions.android.minSdk.get().toInt()
        targetSdk = libs.versions.android.targetSdk.get().toInt()
        versionCode = 1
        versionName = "1.0"
    }
    packaging {
        resources {
            excludes += "/META-INF/{AL2.0,LGPL2.1}"
        }
    }
    buildTypes {
        getByName("release") {
            isMinifyEnabled = false
        }
    }
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_11
        targetCompatibility = JavaVersion.VERSION_11
    }
    buildFeatures {
        compose = true
    }
    dependencies {
        debugImplementation(compose.uiTooling)
    }
}

room {
    schemaDirectory("$projectDir/schemas")
}

项目根目录 build.gradle.kt #

plugins {
    // this is necessary to avoid the plugins to be loaded multiple times
    // in each subproject's classloader
    alias(libs.plugins.androidApplication) apply false
    alias(libs.plugins.androidLibrary) apply false
    alias(libs.plugins.jetbrainsCompose) apply false
    alias(libs.plugins.compose.compiler) apply false
    alias(libs.plugins.kotlinMultiplatform) apply false
}

libs.versions.toml #

[versions]
agp = "8.2.2"
android-compileSdk = "34"
android-minSdk = "24"
android-targetSdk = "34"
androidx-activityCompose = "1.9.0"
androidx-appcompat = "1.7.0"
androidx-constraintlayout = "2.1.4"
androidx-core-ktx = "1.13.1"
androidx-espresso-core = "3.5.1"
androidx-material = "1.12.0"
androidx-test-junit = "1.1.5"
compose-plugin = "1.6.10"
junit = "4.13.2"
kotlin = "2.0.0"
kotlinxCoroutinesCore = "1.9.0-RC"
multiplatformSettings = "1.1.1"
androidx-room = "2.7.0-alpha04"
ksp = "1.9.23-1.0.19"

[libraries]
androidx-room-compiler = { module = "androidx.room:room-compiler", version.ref = "androidx-room" }
androidx-room-gradle-plugin = { module = "androidx.room:room-gradle-plugin", version.ref = "androidx-room" }
androidx-room-runtime = { module = "androidx.room:room-runtime", version.ref = "androidx-room" }
kotlin-test = { module = "org.jetbrains.kotlin:kotlin-test", version.ref = "kotlin" }
kotlin-test-junit = { module = "org.jetbrains.kotlin:kotlin-test-junit", version.ref = "kotlin" }
junit = { group = "junit", name = "junit", version.ref = "junit" }
androidx-core-ktx = { group = "androidx.core", name = "core-ktx", version.ref = "androidx-core-ktx" }
androidx-test-junit = { group = "androidx.test.ext", name = "junit", version.ref = "androidx-test-junit" }
androidx-espresso-core = { group = "androidx.test.espresso", name = "espresso-core", version.ref = "androidx-espresso-core" }
androidx-appcompat = { group = "androidx.appcompat", name = "appcompat", version.ref = "androidx-appcompat" }
androidx-material = { group = "com.google.android.material", name = "material", version.ref = "androidx-material" }
androidx-constraintlayout = { group = "androidx.constraintlayout", name = "constraintlayout", version.ref = "androidx-constraintlayout" }
androidx-activity-compose = { module = "androidx.activity:activity-compose", version.ref = "androidx-activityCompose" }
kotlinx-coroutines-core = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-core", version.ref = "kotlinxCoroutinesCore" }
multiplatform-settings = { module = "com.russhwolf:multiplatform-settings", version.ref = "multiplatformSettings" }

[plugins]
androidApplication = { id = "com.android.application", version.ref = "agp" }
androidLibrary = { id = "com.android.library", version.ref = "agp" }
jetbrainsCompose = { id = "org.jetbrains.compose", version.ref = "compose-plugin" }
compose-compiler = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" }
kotlinMultiplatform = { id = "org.jetbrains.kotlin.multiplatform", version.ref = "kotlin" }
ksp = { id = "com.google.devtools.ksp", version.ref = "ksp" }
room = { id = "androidx.room", version.ref = "androidx-room" 

问题解决步骤 #

1. 为非Android目标配置KSP依赖 #

Room的instantiateImpl由KSP生成，但当前仅在commonMain添加了runtime依赖，需为iOS等非Android目标添加KSP处理器依赖：
在composeApp/build.gradle.kts的sourceSets块中补充：

sourceSets {
    // ... 原有配置
    val iosMain by getting
    iosMain.dependencies {
        implementation(libs.androidx.room.runtime)
        ksp(libs.androidx.room.compiler)
    }
    // 若有iosX64Main、iosArm64Main等目标，需分别添加ksp依赖，或用commonIosMain统一配置
}

2. 匹配KSP与Kotlin版本兼容性 #

当前Kotlin版本为2.0.0，但KSP版本1.9.23-1.0.19不匹配，KSP版本需与Kotlin严格对应。更新libs.versions.toml中的ksp版本：

ksp = "2.0.0-1.0.22"

3. 全局配置Room注解处理器 #

在composeApp/build.gradle.kts的kotlin块中添加全局KSP依赖，确保Room为所有平台生成代码：

kotlin {
    // ... 原有配置
    dependencies {
        add("kspCommonMainMetadata", libs.androidx.room.compiler)
    }
}

4. 清理并重新构建项目 #

执行以下Gradle命令清除缓存并重新构建：

./gradlew clean
./gradlew assemble

5. 检查RoomDatabase类的注解 #

确保KwontDb类正确添加@Database注解并继承RoomDatabase：

@Database(entities = [YourEntity::class], version = 1)
abstract class KwontDb : RoomDatabase() {
    abstract fun yourDao(): YourDao
}

内容的提问来源于stack exchange，提问作者MikkelT