Android Room(Kotlin)字段唯一约束添加及indices注解报错解决

嗨，我来帮你解决这个Room唯一约束的问题！你遇到的unresolved reference:indices错误，大概率是两个原因：要么Gradle依赖/插件没配对，要么注解用错了地方。下面一步步给你理清楚：

第一步：先把Gradle配置搞对（关键！） #

Android Studio 3对Room版本有兼容性要求，而且Kotlin必须用kapt来处理Room的注解，不然注解根本识别不了。

1. 配置Module级build.gradle

先确保你加了kotlin-kapt插件，然后引入匹配的Room依赖（推荐用2.2.6版本，适配AS3）：

apply plugin: 'com.android.application'
apply plugin: 'kotlin-android'
apply plugin: 'kotlin-kapt' // 必须加这个，Kotlin注解处理全靠它

android {
    // 你的基础配置，比如compileSdkVersion 28（AS3常用版本）
    defaultConfig {
        // ...其他配置
        javaCompileOptions {
            annotationProcessorOptions {
                arguments = ["room.schemaLocation": "$projectDir/schemas".toString()]
            }
        }
    }
}

dependencies {
    // Room核心依赖
    implementation "androidx.room:room-runtime:2.2.6"
    kapt "androidx.room:room-compiler:2.2.6"
    // 如果需要Coroutines支持，再加这个扩展
    implementation "androidx.room:room-ktx:2.2.6"
}

2. 确认Project级build.gradle的仓库

AS3时期还常用jcenter，确保仓库配置正确：

allprojects {
    repositories {
        google()
        jcenter()
    }
}

配置完记得点击Sync Now同步Gradle，清理下项目（Build -> Clean Project）。

第二步：正确添加唯一约束的两种方式 #

Room提供了两种方式加唯一约束，别把注解用错地方了！

方式一：用@Entity的indices参数（适合多字段联合唯一）

这个是你尝试的indices相关的写法，但注意它是@Entity注解的参数，不是单独加在字段上的！比如要给username字段加唯一约束：

@Entity(indices = [Index(value = ["username"], unique = true)])
data class User(
    @PrimaryKey val id: Int,
    val username: String,
    val email: String
)

如果要做多字段联合唯一，比如username+email不能重复，就把value改成数组：

@Entity(indices = [Index(value = ["username", "email"], unique = true)])

方式二：直接用@Unique注解在字段上（单字段唯一更简单）

如果只是单个字段需要唯一约束，直接在字段上加@Unique注解就行，更直观：

@Entity
data class User(
    @PrimaryKey val id: Int,
    @Unique val username: String,
    val email: String
)

最后排查报错 #

如果还是报unresolved reference，检查这几点：

• 有没有把@Indices错误地加在了字段上（比如直接写在val username上面），这种写法是错的
• 有没有同步Gradle，有没有清理重建项目
• Kotlin版本是不是和Room版本匹配（比如Room 2.2.6对应Kotlin 1.3.72左右）

这样操作下来，应该就能解决你的问题啦！

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