KMM集成Room报错：找不到AppDatabase实现类AppDatabase_Impl

问题根源 #

核心问题是Room注解处理器的Gradle配置不完整：仅配置了Common模块的元数据处理，但Android端缺少单独的KSP配置，导致Android编译阶段无法生成AppDatabase的实现类；同时你添加的DB接口hack反而引发了Room生成代码的冲突，加重了问题。

具体修复步骤 #

1. 补全Gradle的KSP配置（模块级build.gradle.kts） #

首先确保模块已引入KSP插件，同时配置Common和Android端的Room编译器依赖：

plugins {
    kotlin("multiplatform")
    id("com.android.library")
    id("com.google.devtools.ksp") // 必须添加此插件，否则KSP不生效
}

// ... 其他Android、iOS目标配置 ...

dependencies {
    // Common模块依赖
    commonMainImplementation(libs.room.runtime)
    commonMainImplementation(libs.room.ktx)
    add("kspCommonMainMetadata", libs.room.compiler)

    // Android模块单独配置KSP，这是之前缺失的关键
    androidImplementation(libs.room.runtime)
    androidImplementation(libs.room.ktx)
    ksp(libs.room.compiler) // 也可使用kspAndroid(libs.room.compiler)
}

2. 移除冗余的DB接口，修正数据库类 #

DB接口完全多余，Room生成的AppDatabase_Impl会自动继承RoomDatabase的方法，直接删除接口并简化数据库类：

abstract class AppDatabase : RoomDatabase() {
    abstract fun exampleDao(): ExampleDao // 建议遵循小驼峰命名规范

    // 如需重写clearAllTables，直接调用父类实现即可
    override fun clearAllTables() {
        super.clearAllTables()
    }
}

3. 清理构建缓存并重新编译 #

之前的错误构建缓存会残留问题文件，必须执行以下操作：

• 执行Gradle任务：./gradlew clean
• 删除项目根目录下的.gradle文件夹和当前模块的build文件夹
• 重新运行./gradlew assemble或直接启动调试

额外说明 #

iOS端的报错本质是Common模块元数据生成不完整，补全KSP配置并清理缓存后，Common模块会生成正确的元数据，iOS端即可正常引用Room相关代码。

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