JPA/Hibernate嵌入实体非主键OneToMany关联报错求助

问题原因 #

报错的核心原因有两点：

1. DeclarantAddress的@ManyToOne关联指向BaseRecord，并指定referencedColumnName = "DECLARANT_ID"，但BaseRecord实体没有直接映射到DECLARANT_ID列的属性——该列是由嵌入实体DeclarantRecord的declarantId属性映射的，Hibernate无法识别嵌入实体中的列作为关联目标的属性。
2. 将@OneToMany放在嵌入实体DeclarantRecord中不符合JPA设计规范：嵌入实体是宿主实体的一部分，不应该持有独立的实体间关联关系，关联关系应归属宿主实体（BaseRecord）。

解决方案 #

方案1：规范关联关系归属（推荐） #

将关联关系移到宿主实体BaseRecord中，调整后的代码如下：

修改BaseRecord类

@Getter
@Setter
@Entity
@AllArgsConstructor
@NoArgsConstructor
@Table(name = "BASE_RECORD")
public class BaseRecord {

    @Id
    @Column(name = "DB_ID")
    public Long id;

    @Embedded
    public DeclarantRecord declarant;

    // 将关联关系移至宿主实体，指定外键关联DECLARANT_ID列
    @OneToMany(fetch = FetchType.EAGER)
    @JoinColumn(name = "PERS_ID", referencedColumnName = "DECLARANT_ID")
    public List<DeclarantAddress> addresses;
}

修改DeclarantRecord类

移除嵌入实体中的关联关系：

@Getter
@Setter
@Embeddable
@AllArgsConstructor
@NoArgsConstructor
public class DeclarantRecord {

    @Column(name = "DECLARANT_ID")
    public String declarantId;

    @Column(name = "DECLARANT_IDE")
    public String identificationNumber;

    @Column(name = "DECLARANT_NAME")
    public String name;

    // 移除原有的addresses关联
}

修改DeclarantAddress类

保持双向关联的正确性：

@Getter
@Setter
@Entity
@NoArgsConstructor
@AllArgsConstructor
@Table(name = "ADDRESS_RECORD")
public class DeclarantAddress {

    @Id
    @Column(name = "DB_ID")
    public Long id;

    @ManyToOne
    @JoinColumn(name = "PERS_ID", referencedColumnName = "DECLARANT_ID")
    public BaseRecord baseRecord;
}

方案2：临时兼容原有结构 #

如果不想调整关联关系位置，可以在BaseRecord中添加一个直接映射到DECLARANT_ID列的属性，与嵌入实体的字段共享同一列：

@Getter
@Setter
@Entity
@AllArgsConstructor
@NoArgsConstructor
@Table(name = "BASE_RECORD")
public class BaseRecord {

    @Id
    @Column(name = "DB_ID")
    public Long id;

    @Embedded
    public DeclarantRecord declarant;

    // 显式映射DECLARANT_ID列，设置为不可插入/更新避免冲突
    @Column(name = "DECLARANT_ID", insertable = false, updatable = false)
    public String declarantId;
}

此时Hibernate能识别到BaseRecord有对应DECLARANT_ID列的属性，原有关联配置可保留，不会再抛出异常。

关键说明 #

• 嵌入实体（@Embeddable）是宿主实体的属性集合，不属于独立实体，不应持有@OneToMany这类实体间关联关系，关联关系应归属宿主实体。
• JPA/Hibernate要求关联的referencedColumnName必须对应关联实体的一个可访问属性，直接映射的属性比嵌入实体中的属性更易被框架识别。

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