Android Room实体继承时如何重写父类的PrimaryKey？

错误原因核心 #

你遇到的编译错误，本质是对Room实体继承规则的误解：Room中每个@Entity注解对应一张独立的数据库表，如果父类和子类都标记为@Entity，Room会将它们视为两张完全独立的表，此时子类继承父类的@PrimaryKey字段，又自行定义新的主键，会导致单个实体中出现多个主键声明，违反Room的实体约束。

官方文档提到的“重写PrimaryKey”，指的是子类继承**普通基类（非@Entity注解类）**时，重写父类字段并标记为主键的场景，而非继承另一个@Entity类。

针对性解决思路 #

场景1：单表复用父类字段（Operation作为单表，包含OperationType的所有字段） #

如果你的需求是让Operation表复用OperationType的字段，同时使用自己的主键，调整结构如下：

1. 移除父类OperationType的@Entity注解，将其改为普通open基类
2. 子类Operation标记为@Entity，重写主键字段或定义新主键，同时复用父类字段

示例代码：

// 父类：普通基类，无@Entity注解
open class OperationType {
    open var typeId: Int = 0 // 用open修饰允许子类重写
    var typeName: String = ""
}

// 子类：实体类，重写父类字段作为主键
@Entity(tableName = "operations")
class Operation : OperationType() {
    @PrimaryKey(autoGenerate = true)
    override var typeId: Int = 0 // 重写父类字段并标记为主键
    var operationName: String = ""
}

如果不需要重写父类原字段，而是定义全新主键，可通过@Embedded嵌入父类并忽略原主键：

open class OperationType {
    var typeId: Int = 0
    var typeName: String = ""
}

@Entity(tableName = "operations")
class Operation {
    @PrimaryKey(autoGenerate = true)
    var operationId: Int = 0
    @Embedded(prefix = "type_") // 给父类字段加前缀避免冲突
    var operationType: OperationType = OperationType()
    var operationName: String = ""
}

场景2：多表独立（Operation和OperationType为两张独立表） #

如果两张表是独立的，不要让它们互相继承@Entity类，而是抽取公共字段到一个非@Entity的基类，两个实体分别继承该基类：

// 公共基类：存放两张表的共享字段
open class BaseOperation {
    var createTime: Long = 0
}

@Entity(tableName = "operation_types")
class OperationType : BaseOperation() {
    @PrimaryKey(autoGenerate = true)
    var typeId: Int = 0
    var typeName: String = ""
}

@Entity(tableName = "operations")
class Operation : BaseOperation() {
    @PrimaryKey(autoGenerate = true)
    var operationId: Int = 0
    var operationName: String = ""
    // 如需关联，添加外键
    @ForeignKey(entity = OperationType::class, parentColumns = ["typeId"], childColumns = ["bindTypeId"])
    var bindTypeId: Int = 0
}

关键注意事项 #

• 永远不要让两个@Entity注解的类互相继承，Room不会将这种关系解析为表结构继承，只会导致注解冲突
• 复用字段优先使用@Embedded或普通基类继承，而非@Entity类继承
• 重写主键时，父类对应字段必须用open修饰，确保子类可以覆盖并重新标记@PrimaryKey

内容的提问来源于stack exchange，提问作者Joe T.