如何使用Hibernate映射包含外键的复合主键？

先来说说你遇到的核心问题：当复合主键中的一个字段同时是外键时，直接在@Embeddable类里用@Column标注外键字段是行不通的，Hibernate需要明确这个字段和关联实体的关系。下面给你两种可行的实现方案，结合你的代码来调整：

方案一：使用@EmbeddedId + @MapsId（推荐） #

这种方式把复合主键定义为可嵌入类，然后在主实体类中通过@MapsId将外键关联到主键字段上，逻辑更清晰，耦合度更低。

1. 修正复合主键类（@Embeddable） #

首先，你的CamposObrigatoriosID必须实现Serializable，并且必须重写equals()和hashCode()（这是Hibernate识别复合主键的关键，很多人会漏掉这一步）。另外，外键字段只需要定义基本类型，不用加@Column，关联关系放在主实体类中处理：

@Embeddable
public class CamposObrigatoriosID implements Serializable {
    private static final long serialVersionUID = 1L;

    // 对应关联表的主键，作为外键的字段
    private Long perfil;

    // 复合主键的另一个字段（替换成你实际的字段，比如campoId）
    private Long campoId;

    // 必须提供无参构造器（Hibernate反射实例化需要）
    public CamposObrigatoriosID() {}

    // 带参构造器（可选，方便实例化主键对象）
    public CamposObrigatoriosID(Long perfil, Long campoId) {
        this.perfil = perfil;
        this.campoId = campoId;
    }

    // 重写equals和hashCode，基于主键字段的逻辑判断
    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        CamposObrigatoriosID that = (CamposObrigatoriosID) o;
        return Objects.equals(perfil, that.perfil) && Objects.equals(campoId, that.campoId);
    }

    @Override
    public int hashCode() {
        return Objects.hash(perfil, campoId);
    }

    // getter和setter方法
    public Long getPerfil() { return perfil; }
    public void setPerfil(Long perfil) { this.perfil = perfil; }
    public Long getCampoId() { return campoId; }
    public void setCampoId(Long campoId) { this.campoId = campoId; }
}

2. 主实体类的映射 #

在主实体类中，用@EmbeddedId标注主键，然后用@ManyToOne关联外键对应的实体，同时通过@MapsId("perfil")指定这个关联对应主键类中的perfil字段：

@Entity
@Table(name = "SEU_NOME_DE_TABELA") // 替换成你的实际表名
public class CamposObrigatorios {
    @EmbeddedId
    private CamposObrigatoriosID id;

    // 关联的实体（比如Perfil类，对应你说的图2的表）
    @ManyToOne(fetch = FetchType.LAZY)
    @MapsId("perfil") // 这里的"perfil"对应主键类中的perfil字段
    @JoinColumn(name = "PERFIL_CMPOBR") // 数据库中外键列的实际名称
    private Perfil perfil;

    // 其他实体字段示例
    @Column(name = "DESCRICAO")
    private String descricao;

    // 构造器、getter和setter
    public CamposObrigatorios() {}

    public CamposObrigatorios(CamposObrigatoriosID id, Perfil perfil) {
        this.id = id;
        this.perfil = perfil;
    }

    // getter和setter方法
    public CamposObrigatoriosID getId() { return id; }
    public void setId(CamposObrigatoriosID id) { this.id = id; }
    public Perfil getPerfil() { return perfil; }
    public void setPerfil(Perfil perfil) { this.perfil = perfil; }
    public String getDescricao() { return descricao; }
    public void setDescricao(String descricao) { this.descricao = descricao; }
}

3. 关联实体类（比如Perfil） #

这个类是对应图2表的普通实体类，主键类型要和主实体主键中的perfil字段匹配：

@Entity
@Table(name = "TABELA_PERFIL") // 替换成实际表名
public class Perfil {
    @Id
    @Column(name = "ID_PERFIL")
    private Long id;

    // 其他字段示例
    private String nomePerfil;

    // getter和setter
    public Long getId() { return id; }
    public void setId(Long id) { this.id = id; }
    public String getNomePerfil() { return nomePerfil; }
    public void setNomePerfil(String nomePerfil) { this.nomePerfil = nomePerfil; }
}

方案二：在@Embeddable类中直接关联实体（可选，不推荐） #

如果你想在可嵌入类中直接处理关联关系，也可以这样写，但这种方式会让主键类依赖实体类，耦合度更高：

@Embeddable
public class CamposObrigatoriosID implements Serializable {
    private static final long serialVersionUID = 1L;

    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "PERFIL_CMPOBR")
    private Perfil perfil;

    @Column(name = "CAMPO_ID")
    private Long campoId;

    // 同样需要无参构造器、equals、hashCode、getter/setter
    // equals和hashCode要基于perfil的主键和campoId实现
    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        CamposObrigatoriosID that = (CamposObrigatoriosID) o;
        return Objects.equals(perfil != null ? perfil.getId() : null, that.perfil != null ? that.perfil.getId() : null) &&
               Objects.equals(campoId, that.campoId);
    }

    @Override
    public int hashCode() {
        return Objects.hash(perfil != null ? perfil.getId() : null, campoId);
    }

    // getter和setter方法
    public Perfil getPerfil() { return perfil; }
    public void setPerfil(Perfil perfil) { this.perfil = perfil; }
    public Long getCampoId() { return campoId; }
    public void setCampoId(Long campoId) { this.campoId = campoId; }
}

主实体类直接用@EmbeddedId即可：

@Entity
@Table(name = "SEU_NOME_DE_TABELA")
public class CamposObrigatorios {
    @EmbeddedId
    private CamposObrigatoriosID id;

    // 其他字段...
}

常见问题排查 #

• 你之前的代码大概率没重写equals()和hashCode()，这会导致Hibernate无法正确识别复合主键，进而引发持久化异常。
• 外键字段不要同时用@Column和@ManyToOne，否则会导致重复映射同一列，引发冲突。
• 确保所有实体类和可嵌入类都有无参构造器，Hibernate在反射实例化时需要用到。

内容的提问来源于stack exchange，提问作者Sérgio M.