使用Room数据库时出现:app:kaptDebugKotlin编译错误求助

报错信息 #

• 实体类必须标注@Entity注解 - androidx.room.Entity
• 实体类和POJO需有可用公共构造函数，可提供空构造函数或参数匹配字段的构造函数 - androidx.room.Entity
• 实体必须至少有一个字段标注@PrimaryKey注解 - androidx.room.Entity
• [SQLITE_ERROR] SQL错误或数据库缺失（")"附近存在语法错误） - androidx.room.Entity

当前配置代码 #

项目build.gradle #

plugins {
    id 'com.android.application'
    id 'org.jetbrains.kotlin.android'
    id 'kotlin-android-extensions'
    id 'kotlin-kapt'
    id 'kotlin-android'
}

android {
    compileSdk 33

    defaultConfig {
        applicationId "com.example.todolist"
        minSdk 21
        targetSdk 33
        versionCode 1
        versionName "1.0"

        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
    kotlinOptions {
        jvmTarget = '1.8'
    }
}

dependencies {

    implementation 'androidx.core:core-ktx:1.9.0'

    implementation 'androidx.appcompat:appcompat:1.5.1'
    implementation 'com.google.android.material:material:1.7.0'
    implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
    testImplementation 'junit:junit:4.13.2'
    androidTestImplementation 'androidx.test.ext:junit:1.1.4'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.0'

    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.6.4")
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.6.4")

    //room
     def    room_version = '2.4.3'
    implementation("androidx.room:room-runtime:$room_version")
    annotationProcessor "androidx.room:room-compiler:$room_version"
    kapt("androidx.room:room-compiler:$room_version")
    implementation("androidx.room:room-ktx:$room_version")
}

实体类代码 #

import androidx.room.Entity
import androidx.room.PrimaryKey

@Entity(tableName = "To_do")
data class Entity(
    @PrimaryKey(autoGenerate = true)
    var id: Int,
    var title: String,
    var priority: String
)

修复步骤 #

1. 清理重复的Room编译依赖 #

Kotlin项目仅需使用kapt处理Room注解，删除annotationProcessor依赖，避免注解处理冲突：

// 移除该行
// annotationProcessor "androidx.room:room-compiler:$room_version"

2. 修正实体类主键与类名 #

• 由于id设置了autoGenerate = true，Room会自动生成主键值，需给id添加默认值，确保构造函数符合Room要求
• 修改类名避免与@Entity注解同名，减少编译混淆
  修正后的实体类：

import androidx.room.Entity
import androidx.room.PrimaryKey

@Entity(tableName = "To_do")
data class TodoEntity(
    @PrimaryKey(autoGenerate = true)
    var id: Int = 0, // 添加默认值
    var title: String,
    var priority: String
)

3. 清理并重建项目 #

执行Build -> Clean Project后再执行Build -> Rebuild Project，清除编译缓存并重新构建。

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