多模块项目中Android Compose与KSP、ROOM兼容问题

算力阿峰

2026-7-13

问题：启用Compose后KSP+Room在多模块项目中出现MissingType异常

问题现象

在多模块Android项目中启用Compose（添加buildFeatures { compose true }配置）后，使用KSP处理Room时出现构建异常：

[ksp] [MissingType]: Element 'pl.softfly.multi_module_room.entity.Card' references a type that is not present - pl.softfly.multi_module_room.entity.Card

模块中的Room无法找到父项目中的Room实体类，移除Compose配置后构建恢复正常。

解决方案尝试

以下是几个已验证可行的解决方向：

1. 统一依赖版本，确保兼容性

Compose Compiler、KSP与Kotlin版本存在严格的兼容性匹配要求，需在项目根目录的build.gradle中统一管理版本：

ext {
    kotlin_version = "1.9.0"
    compose_compiler_version = "1.5.3" // 需与Kotlin版本对应，可参考官方兼容性表
    ksp_version = "1.9.0-1.0.13" // KSP版本需与Kotlin版本一致
    room_version = "2.5.2"
}

所有模块中引入依赖时使用统一版本，避免版本不一致导致的类路径冲突。

2. 调整模块依赖的暴露方式

若实体类所在的父模块是library类型，确保子模块依赖时使用api而非implementation，让子模块能正确访问到实体类：

// 子模块的build.gradle中
api project(":entity-module") // 替换为你的实体类模块名称

同时确保Room核心依赖（room-runtime、room-ktx）在需要的模块中正确引入，且版本统一。

3. 显式配置KSP的SourceSets

在启用Compose的模块中，显式指定KSP生成代码的目录，确保Gradle能正确识别生成的类：

// 模块的build.gradle中
ksp {
    arg("room.schemaLocation", "$projectDir/schemas") // 可选，Room schema配置
}

sourceSets {
    main {
        java.srcDirs("build/generated/ksp/main/kotlin")
    }
}

配置完成后执行./gradlew clean build清理缓存并重新构建。