You need to enable JavaScript to run this app. Kotlin 1.5.10升级1.5.20后Room实体继承出现主键覆盖构建报错
优惠活动
大模型
产品
解决方案
定价
更多

Kotlin 1.5.10升级1.5.20后Room实体继承出现主键覆盖构建报错

问题解决方法

问题原因

这个报错是Kotlin 1.5.20优化了注解继承解析逻辑后,Room的主键校验规则被严格触发导致的,你原代码存在两处不符合Room规范的写法:

  • 你将需要被继承的公共字段父类Child标记了@Entity注解,被该注解标记的类会被Room识别为独立的表结构,强制要求配置主键
  • 子类Parent继承自实体类Child后又重新定义了主键,触发了Room的主键覆盖校验规则,Kotlin 1.5.10版本下注解解析逻辑存在漏洞,没有识别到这个错误,所以可以正常构建。

解决步骤

方案一:父类不需要单独建表(绝大多数复用字段场景的选择)

如果Child只是用来封装公共字段,不需要作为独立的表存储,将父类的@Entity注解替换为@MappedSuperclass注解即可,该注解的作用是让Room将父类的字段自动映射到所有继承它的子类实体表中,本身不会被识别为独立表,不需要配置主键。
修改后父类代码示例:

@MappedSuperclass
open class Child(
    @ColumnInfo(name = "child_id")
    var childId: Int? = null,

    @SerializedName("description")
    var description: String? = null

) : Serializable {...}

子类Parent的代码无需改动,重新构建即可解决报错。

方案二:父类和子类都需要作为独立表存储

如果Child本身也需要对应数据库中的一张表,就不要用继承的方式复用字段,将公共字段抽离为单独的@MappedSuperclass基类,Child和Parent都继承该基类,各自定义自己的主键即可。
示例:

// 公共字段基类
@MappedSuperclass
open class BaseModel(
    @SerializedName("description")
    var description: String? = null
) : Serializable

// Child实体
@Entity
open class Child(
    @ColumnInfo(name = "child_id")
    @PrimaryKey(autoGenerate = true)
    var childId: Int? = null
) : BaseModel()

// Parent实体
@Entity
class Parent(
    @ColumnInfo(name = "parent_id")
    @PrimaryKey(autoGenerate = true)
    var parentId: Int? = null,
    @SerializedName("name")
    var name: String? = null
) : BaseModel()

补充说明

不要尝试直接移除父类的主键保留@Entity注解,被@Entity标记的类强制要求配置主键,不符合规则一定会触发构建失败。

内容的提问来源于stack exchange,提问作者Romain Barbier

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.14 13:06:07