如何在Hibernate中映射复合主键的单字段关联？

这个问题我之前也碰到过，Hibernate对复合主键的关联逻辑比较严格，当你尝试用单字段关联复合主键实体时，它会默认认为你要关联整个主键，所以才抛出了那个异常。下面给你两种可行的解决方案，完全不需要修改现有数据库schema：

方案一：将复合主键中的字段暴露为实体普通属性 #

这种方法最直接，我们在Tree实体中把复合主键里的id字段单独暴露出来（映射到同一张表的id列，但不参与插入和更新操作），这样Hibernate就能识别到这是一个可关联的单字段了。

修改后的代码： #

Tree类

@Entity
@Table(name = "tree")
public class Tree implements Serializable {
    @EmbeddedId
    protected TreePK treePK;
    
    // 新增字段：映射到同列，不参与CRUD操作
    @Column(name = "id", insertable = false, updatable = false)
    private Integer id;

    @OneToOne(mappedBy = "tree")
    private Activity activity;

    // 别忘了添加getter和setter方法
}

TreePK类（保持不变）

@Embeddable
public class TreePK implements Serializable {
    @Column(name = "id")
    private Integer id; // 关联volume表的外键
    @Column(name = "volume_id")
    private Integer volumeId;

    // 必须实现equals()和hashCode()方法
    // 添加getter和setter
}

Activity类（只需保持原有关联配置）

@Entity
@Table(name = "activity")
public class Activity implements Serializable {
    @Id
    private Integer id;
    
    @OneToOne
    @JoinColumn(name = "tree_id", referencedColumnName = "id")
    private Tree tree;

    // getter和setter
}

方案二：使用@JoinColumns指定部分主键字段（不推荐，仅作补充） #

如果你不想修改Tree实体，可以尝试用@JoinColumns强制指定关联字段，但需要额外添加一个不参与操作的虚拟字段来匹配复合主键的另一部分，这种方法比较繁琐，不如方案一优雅：

@Entity
@Table(name = "activity")
public class Activity implements Serializable {
    @Id
    private Integer id;
    
    @OneToOne
    @JoinColumns({
        @JoinColumn(name = "tree_id", referencedColumnName = "id"),
        // 虚拟匹配复合主键的另一部分，不允许插入更新
        @JoinColumn(name = "dummy_volume_id", referencedColumnName = "volume_id", 
                   insertable = false, updatable = false)
    })
    private Tree tree;

    // getter和setter
}

关键注意点 #

• 如果你使用方案一，要确保Tree表中的id字段在业务上是唯一的，否则@OneToOne关联可能会出现数据匹配错误（如果多个Tree共享同一个id）。如果id不唯一，建议把关联改成@ManyToOne。
• 复合主键类TreePK必须正确实现equals()和hashCode()方法，这是Hibernate识别复合主键的必要条件。

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