如何在JPA/Hibernate中基于嵌入式列配置关联映射？

1. 确认可嵌入类ObjectRef的定义 #

确保类实现Serializable，并正确映射数据库列：

@Embeddable
public class ObjectRef implements Serializable {
    @Column(name = "object_id")
    private String objectId;

    @Column(name = "object_type")
    private String objectType;

    // 必须实现equals()、hashCode()，以及构造器、getter/setter
}

2. 配置Person实体的复合自然ID #

用@NaturalId标记嵌入式的ObjectRef，明确这是实体的自然键：

@Entity
@Table(name = "person")
public class Person {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @NaturalId(mutable = false)
    @Embedded
    private ObjectRef objectRef;

    // 其他业务字段及getter/setter
}

3. 配置Document实体与Person的关联 #

通过@JoinColumns指定复合外键，并用@NaturalIdReference告诉Hibernate关联的是Person的自然ID而非主键：

@Entity
@Table(name = "document")
public class Document {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    // 关联Person的复合自然ID，注意外键列名不要和自身列冲突
    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumns({
        @JoinColumn(name = "person_object_id", referencedColumnName = "object_id", nullable = false),
        @JoinColumn(name = "person_object_type", referencedColumnName = "object_type", nullable = false)
    })
    @NaturalIdReference // Hibernate专属注解，指定关联目标的自然ID
    private Person person;

    // 若Document自身也有复合自然ID，单独定义：
    // @NaturalId(mutable = false)
    // @Embedded
    // private ObjectRef documentRef;

    // 其他业务字段及getter/setter
}

4. 高效查询示例 #

现在可以通过关联直接编写Spring Data JPA方法或JPQL，生成单SQL查询：

// Spring Data JPA 方法定义
List<Document> findByPerson_ObjectRef_ObjectIdAndPerson_ObjectRef_ObjectType(String objectId, String objectType);

// 或自定义JPQL
@Query("SELECT d FROM Document d WHERE d.person.objectRef.objectId = :id AND d.person.objectRef.objectType = :type")
List<Document> findByPersonRef(@Param("id") String objectId, @Param("type") String objectType);

常见异常原因 #

• 未给ObjectRef实现Serializable：复合键作为关联字段必须序列化
• 未添加@NaturalIdReference：Hibernate默认尝试关联主键，与配置的复合外键不匹配
• 外键列名与自身列冲突：若Document自身也有object_id/object_type列，需给关联外键指定不同名称（如示例中的person_object_id）

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