Jetpack Compose项目添加Room遇kotlin-kapt插件未找到问题求助

针对你在Jetpack Compose项目中添加Room时遇到的插件找不到错误，按以下步骤排查修复：

1. 修正根目录build.gradle配置 #

确保项目根目录的build.gradle（或build.gradle.kts）里配置了正确的插件仓库和Kotlin插件依赖：

Groovy DSL 示例： #

plugins {
    id 'com.android.application' version '7.4.2' apply false
    id 'com.android.library' version '7.4.2' apply false
    id 'org.jetbrains.kotlin.android' version '1.8.20' apply false
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}

Kotlin DSL 示例： #

plugins {
    id("com.android.application") version "7.4.2" apply false
    id("com.android.library") version "7.4.2" apply false
    id("org.jetbrains.kotlin.android") version "1.8.20" apply false
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}

2. 正确配置模块级build.gradle #

在app模块的build.gradle中，先应用Kotlin Android插件，再添加kotlin-kapt插件，同时配置Room依赖：

Groovy DSL 示例： #

plugins {
    id 'com.android.application'
    id 'org.jetbrains.kotlin.android'
    id 'kotlin-kapt' // 必须放在kotlin-android插件之后
}

android {
    compileSdk 33

    defaultConfig {
        applicationId "com.example.audiohub"
        minSdk 24
        targetSdk 33
        // 其他配置如versionCode、versionName等
    }

    buildFeatures {
        compose true // 保留Compose配置
    }

    composeOptions {
        kotlinCompilerExtensionVersion "1.4.3"
    }
}

dependencies {
    // Room核心依赖
    implementation "androidx.room:room-runtime:2.5.0"
    kapt "androidx.room:room-compiler:2.5.0"
    implementation "androidx.room:room-ktx:2.5.0"

    // 你的Compose依赖（按需保留）
    implementation 'androidx.compose.ui:ui:1.4.3'
    implementation 'androidx.compose.material3:material3:1.1.0'
    // ...其他依赖
}

3. 同步并重建项目 #

• 点击Android Studio右上角的「Sync Project with Gradle Files」按钮完成同步
• 执行Build > Clean Project，再执行Build > Rebuild Project

关键注意点 #

• 不要在根build.gradle的plugins块中直接应用kotlin-kapt，必须在模块级别配置
• 确保Kotlin版本与Room版本兼容，可参考官方文档的版本适配说明
• 检查仓库配置是否包含google()和mavenCentral()，这两个是下载插件的必要仓库

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