Hibernate单表继承与IdClass配置异常及数据存储问题求助

你遇到的核心矛盾是**type字段同时承担了两个映射角色：单表继承的鉴别器列，以及复合主键的组成部分**。Hibernate不允许同一列被实体类同时映射为普通主键属性和鉴别器列，因此启动时会报重复映射错误；但如果给主键的type字段添加insert=false, update=false，Hibernate会放弃自动填充该字段，导致保存/查询时type为null，无法通过主键唯一识别实体。

下面提供两种可行的修复方案，均无需子类手动指定type属性，完全由Hibernate继承机制自动维护：

方案一：基于@IdClass的调整（适配原有主键配置） #

1. 修改复合主键类ProjectPropertyPK #

import java.io.Serializable;
import jakarta.persistence.Column;
import jakarta.persistence.Embeddable;

@Embeddable
public class ProjectPropertyPK implements Serializable {
    @Column(name = "project_id")
    private Long projectId;
    
    // 仅定义字段，不做可插入/可更新配置
    @Column(name = "type")
    private String type;

    // 必实现：构造器、equals()、hashCode()、getter/setter
}

2. 修改抽象父类ProjectPropertyAbstract #

import jakarta.persistence.*;

@Entity
@Table(name = "project_property")
@Inheritance(strategy = InheritanceType.SINGLE_TABLE)
@DiscriminatorColumn(name = "type", discriminatorType = DiscriminatorType.STRING)
@IdClass(ProjectPropertyPK.class)
public abstract class ProjectPropertyAbstract {
    @Id
    @Column(name = "project_id")
    private Long projectId;

    @Id
    // 标记为不可插入/更新，避免与鉴别器列冲突
    @Column(name = "type", insertable = false, updatable = false)
    private String type;

    // 其他公共属性定义

    // 生命周期回调：持久化前自动同步鉴别器值到主键
    @PrePersist
    public void prePersist() {
        DiscriminatorValue discriminatorValue = this.getClass().getAnnotation(DiscriminatorValue.class);
        if (discriminatorValue != null) {
            this.type = discriminatorValue.value();
        }
    }

    // getter/setter方法
}

3. 子类保持原有配置不变 #

// 薪资基金属性子类
@Entity
@DiscriminatorValue("WAGE_FUND")
public class ProjectWageFundProperty extends ProjectPropertyAbstract {
    // 子类专属属性
}

// 跨岗配置属性子类
@Entity
@DiscriminatorValue("CROSS_STAFFING")
public class ProjectCrossStaffingProperty extends ProjectPropertyAbstract {
    // 子类专属属性
}

方案二：改用@EmbeddedId（更推荐的灵活方案） #

1. 修改嵌入式主键类ProjectPropertyPK #

import java.io.Serializable;
import jakarta.persistence.Column;
import jakarta.persistence.Embeddable;

@Embeddable
public class ProjectPropertyPK implements Serializable {
    @Column(name = "project_id")
    private Long projectId;
    
    // 直接标记为不可插入/更新
    @Column(name = "type", insertable = false, updatable = false)
    private String type;

    // 必实现：构造器、equals()、hashCode()、getter/setter
}

2. 修改抽象父类ProjectPropertyAbstract #

import jakarta.persistence.*;

@Entity
@Table(name = "project_property")
@Inheritance(strategy = InheritanceType.SINGLE_TABLE)
@DiscriminatorColumn(name = "type", discriminatorType = DiscriminatorType.STRING)
public abstract class ProjectPropertyAbstract {
    @EmbeddedId
    private ProjectPropertyPK id;

    // 其他公共属性定义

    // 生命周期回调：同步鉴别器值到嵌入式主键
    @PrePersist
    public void prePersist() {
        DiscriminatorValue discriminatorValue = this.getClass().getAnnotation(DiscriminatorValue.class);
        if (discriminatorValue != null && id != null) {
            id.setType(discriminatorValue.value());
        }
    }

    // getter/setter方法
}

3. 子类配置与方案一完全一致 #

• @PrePersist生命周期回调会在Hibernate持久化实体前执行，此时子类的@DiscriminatorValue已确定，通过反射获取该值并手动填充到主键的type字段，解决了insert=false, update=false导致的字段为空问题。
• 主键的type字段标记为不可插入/更新，彻底避免了与鉴别器列的映射冲突，同时由Hibernate的继承机制保证type列的正确性。

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