JPA+Hibernate四级实体外键未继承问题咨询

实体层级结构 #

一级实体 #

@Entity
public class LevelOne {
    @Id
    private long levelOnePK;

    @OneToMany(mappedBy = "levelOne")
    private Set<LevelTwo> levelTwo;   

    // getters setters omitted 
}

二级实体 #

@Entity
public class LevelTwo {

    @Id
    private long levelTwoPK;

    @ManyToOne
    @JoinColumn(name = "levelOnePK")
    private LevelOne levelOne;

    @OneToMany(mappedBy = "levelTwo")
    private Set<LevelThree> levelThree;

    // getters setters omitted
}

三级实体 #

@Entity
public class LevelThree {

    @Id
    private long levelThreePK;

    @ManyToOne
    @JoinColumn(name = "levelOnePK")
    @JoinColumn(name = "levelTwoPK")
    private LevelTwo levelTwo;

    @OneToMany(mappedBy = "levelThree")
    private Set<LevelFour> levelFour;

    // getters setters omitted
}

四级实体（报错） #

@Entity
public class LevelFour {

    @Id
    private long levelFourPK;

    @ManyToOne
    @JoinColumn(name = "levelOnePK")
    @JoinColumn(name = "levelTwoPK")
    @JoinColumn(name = "levelThreePK")
    private LevelThree levelThree;

    // getters setters omitted
}

报错信息 #

"It is not mapped to a single entity"

问题分析 #

前三级实体可正常运行，但四级实体添加多个@JoinColumn关联上级所有主键时出错，核心原因是：
JPA中，@ManyToOne注解下的多个@JoinColumn是用来关联复合主键类型的目标实体的。但你的LevelThree实体主键是单一的long类型（levelThreePK），并非复合主键。当你给LevelFour的@ManyToOne配置三个@JoinColumn时，JPA会认为目标实体LevelThree的主键是这三个字段组成的复合键，但实际LevelThree只有一个主键字段，因此触发“未映射到单个实体”的错误。

而仅关联levelThreePK时能正常工作，是因为此时@JoinColumn匹配了LevelThree的单一主键，符合JPA的关联规则。

解决方案 #

方案一：单独存储上级主键字段（无需修改现有主键结构） #

如果只是需要在LevelFour中保留所有上级层级的主键值，无需通过多外键关联LevelThree，可以单独声明这些字段，并通过JPA映射保证数据一致性：

修改后的四级实体：

@Entity
public class LevelFour {

    @Id
    private long levelFourPK;

    // 正常关联LevelThree的单一主键
    @ManyToOne
    @JoinColumn(name = "levelThreePK")
    private LevelThree levelThree;

    // 单独存储上级层级的主键，设置为不可手动修改，从关联实体同步值
    @Column(name = "levelOnePK", insertable = false, updatable = false)
    private long levelOnePK;

    @Column(name = "levelTwoPK", insertable = false, updatable = false)
    private long levelTwoPK;

    // getters setters omitted
}

同时需要在LevelThree中添加对应的主键映射字段，让JPA可以从关联实体中获取这些值：

@Entity
public class LevelThree {

    @Id
    private long levelThreePK;

    @ManyToOne
    @JoinColumn(name = "levelOnePK")
    @JoinColumn(name = "levelTwoPK")
    private LevelTwo levelTwo;

    // 映射上级主键字段，不允许手动修改
    @Column(insertable = false, updatable = false)
    private long levelOnePK;

    @Column(insertable = false, updatable = false)
    private long levelTwoPK;

    @OneToMany(mappedBy = "levelThree")
    private Set<LevelFour> levelFour;

    // getters setters omitted
}

方案二：将三级实体改为复合主键（彻底实现多键关联） #

如果业务逻辑要求必须通过所有上级主键关联LevelThree，需要将LevelThree的主键改为复合主键，包含levelOnePK、levelTwoPK、levelThreePK三个字段：

1. 创建复合主键类：

@Embeddable
public class LevelThreePK implements Serializable {
    private long levelOnePK;
    private long levelTwoPK;
    private long levelThreePK;

    // 必须实现equals和hashCode方法
    // 构造函数、getters setters omitted
}

2. 修改三级实体：

@Entity
public class LevelThree {

    @EmbeddedId
    private LevelThreePK id;

    // 通过@MapsId关联LevelOne的主键到复合主键的对应字段
    @ManyToOne
    @MapsId("levelOnePK")
    @JoinColumn(name = "levelOnePK")
    private LevelOne levelOne;

    // 通过@MapsId关联LevelTwo的主键到复合主键的对应字段
    @ManyToOne
    @MapsId("levelTwoPK")
    @JoinColumn(name = "levelTwoPK")
    private LevelTwo levelTwo;

    @OneToMany(mappedBy = "levelThree")
    private Set<LevelFour> levelFour;

    // getters setters omitted
}

3. 修改四级实体，关联复合主键：

@Entity
public class LevelFour {

    @Id
    private long levelFourPK;

    @ManyToOne
    @JoinColumn(name = "levelOnePK", referencedColumnName = "levelOnePK")
    @JoinColumn(name = "levelTwoPK", referencedColumnName = "levelTwoPK")
    @JoinColumn(name = "levelThreePK", referencedColumnName = "levelThreePK")
    private LevelThree levelThree;

    // getters setters omitted
}

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