Room数据库关联构建失败：实体注解冲突问题求助

核心错误原因 #

1. 错误标记@Entity：MovieWithCastDbModel 是用来接收关联查询结果的POJO类，并非数据库表的映射，不能加@Entity注解。Room明确规定实体类（Entity）不能包含@Relation注解——@Relation是用于查询时组装关联数据的逻辑，不属于表结构定义范畴。

2. 错误加入Database实体列表：你移除@Entity后仍报错，大概率是把MovieWithCastDbModel加到了RoomDatabase的@Database(entities = [...])数组里。这个数组只能存放真正对应数据库表的Entity类（比如CastDbModel、MovieDbModel），不能放关联查询用的POJO。

分步解决 #

1. 修正MovieWithCastDbModel

去掉@Entity注解，将其改为纯POJO类，用于接收关联查询结果：

data class MovieWithCastDbModel(
    @Embedded
    var movie: MovieDbModel,
    @Relation(
        entity = CastDbModel::class,
        // 通过中间表movie_cast关联，需用Junction指定连接表
        parentColumn = "id",
        entityColumn = "id",
        associateBy = Junction(MovieCastCrossRef::class, parentColumn = "movie_id", entityColumn = "cast_id")
    )
    var cast: CastDbModel // 一对一关联用单个对象，多对多场景改用List<CastDbModel>
)

2. 正确定义中间表（movie_cast）

movie_cast作为连接Movie和Cast的关联表，需要单独定义对应的Entity：

@Entity(tableName = "movie_cast", primaryKeys = ["movie_id", "cast_id"])
data class MovieCastCrossRef(
    val movie_id: Int, // 关联Movie表的主键id
    val cast_id: Int   // 关联Cast表的主键id
)

3. 修正RoomDatabase配置

确保@Database注解的entities数组只包含实际的表实体：

@Database(entities = [CastDbModel::class, MovieDbModel::class, MovieCastCrossRef::class], version = 1)
abstract class AppDatabase : RoomDatabase() {
    // 定义DAO接口
}

4. 额外优化：Genres类与TypeConverter

你的Genres类设计冗余，直接用List<Int>存储genre_ids更合理，同时修改TypeConverter：

// 替换原Genres类，在MovieDbModel中直接用List<Int>
@Entity(tableName = "movie")
@TypeConverters(IntListConverter::class)
data class MovieDbModel(
    var page: Int,
    @PrimaryKey(autoGenerate = false)
    var id: Int,
    var poster_path: String,
    var overview: String,
    var title: String,
    @ColumnInfo(name = "genre_ids")
    var genre_ids: List<Int>,
    var runtime: Int
)

// 对应的TypeConverter
class IntListConverter {
    @TypeConverter
    fun fromList(value: List<Int>): String {
        return Gson().toJson(value)
    }

    @TypeConverter
    fun toList(value: String): List<Int> {
        return Gson().fromJson(value, object : TypeToken<List<Int>>() {}.type)
    }
}

关键注意点 #

• Entity类必须严格对应数据库表，只能包含表字段与主键，不能用@Relation关联其他实体（除非是嵌入单个对象的表结构）。
• 关联查询用的POJO类不需要加@Entity，也不能加入Database的entities列表，仅需在DAO中作为查询返回类型使用。

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