Android Room一对多关系构建报错：Entities cannot have relations

核心问题分析 #

错误提示“Entities cannot have relations”的直接原因是Dao查询语句中误用了实体类名而非数据库表名，Room将查询目标错误识别为实体，进而判定实体包含关系注解触发报错。

具体修正步骤 #

1. 修正Dao中的表名引用 #

User实体的tableName定义为"users"，但你在getAll()和getUsersWithActivities()的@Query中写的是SELECT * FROM User——这里的User是实体类名，并非实际数据库表名。

修正后的UserDao：

@Dao
interface UserDao {
    @Query("SELECT * FROM users") // 改为实体定义的表名users
    fun getAll(): List<User>

    @Insert
    fun insertUser(vararg users:User)

    @Update
    fun updateUser(vararg users:User)

    @Delete
    fun deleteUser(vararg users:User)

    @Transaction
    @Query("SELECT * FROM users") // 同步修正表名
    fun getUsersWithActivities(): List<UserAndActivities>
}

2. （可选但推荐）为Activities添加外键约束 #

虽然这不是当前报错的直接原因，但添加外键可以保证数据完整性，符合Room最佳实践：

@Entity(
    tableName = "activities",
    foreignKeys = [ForeignKey(
        entity = User::class,
        parentColumns = ["userId"],
        childColumns = ["userCreatorId"],
        onDelete = ForeignKey.CASCADE // 按需设置删除策略，如CASCADE、RESTRICT等
    )]
)
data class Activities(
    @PrimaryKey(autoGenerate = true) val activityId: Int,
    val userCreatorId: Int,
    @ColumnInfo(name = "activity_date") val activityDate: Long,
    val details: String
)

3. 确认关联数据类的注解正确性 #

确保UserAndActivities没有被错误添加@Entity注解——它只是用于承载关联查询结果的数据类，不需要被Room识别为数据库表。你的当前代码中这部分是正确的，无需修改。

验证修复 #

完成上述修改后，重新执行Gradle构建命令：

./gradlew kspDebugKotlin

若仍有问题，可先清理项目缓存再构建：

./gradlew clean && ./gradlew kspDebugKotlin

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