Spring Boot JPA复合主键引用重复映射错误求解决方案

错误信息 #

[PersistenceUnit: default] Unable to build Hibernate SessionFactory; nested exception is org.hibernate.MappingException: Column 'env_id' is duplicated in mapping for entity 'com.sample.app.entity.GroupResourceAllocation' (use '@Column(insertable=false, updatable=false)' when mapping multiple properties to the same column)

问题原因 #

在GroupResourceAllocation实体中，env_id列被重复映射了三次：

1. 嵌入IDGroupResourceAllocationId中的envId字段对应env_id列
2. 关联Group时的@JoinColumn指定了env_id列
3. 关联Resource时的@JoinColumn也指定了env_id列

即使已经添加了insertable=false, updatable=false，Hibernate仍会检测到冲突，因为嵌入ID本身已绑定该列，关联关系的配置未明确和嵌入ID的字段绑定。

解决方案 #

方案1：调整关联关系的@MapsId配置（不修改嵌入ID结构） #

修改GroupResourceAllocation实体，让关联Group和Resource时，@MapsId指定嵌入ID中的多个字段，明确映射关系：

import jakarta.persistence.*;
import lombok.Data;

@Entity
@Data
public class GroupResourceAllocation {
    @EmbeddedId
    private GroupResourceAllocationId id;

    private String status;

    // 通过嵌入ID的envId关联Environment，无需额外映射
    @ManyToOne
    @JoinColumn(name = "env_id", insertable = false, updatable = false)
    private Environment environment;

    // 映射Group的复合主键，@MapsId指定嵌入ID中的对应字段
    @MapsId({"envId", "groupName"})
    @ManyToOne
    @JoinColumns({
        @JoinColumn(name = "env_id", insertable = false, updatable = false),
        @JoinColumn(name = "group_name", insertable = false, updatable = false)
    })
    private Group group;

    // 映射Resource的复合主键，@MapsId指定嵌入ID中的对应字段
    @MapsId({"envId", "resourceName"})
    @ManyToOne
    @JoinColumns({
        @JoinColumn(name = "env_id", insertable = false, updatable = false),
        @JoinColumn(name = "resource_name", insertable = false, updatable = false)
    })
    private Resource resource;
}

方案2：移除单独的Environment关联（更简洁） #

直接通过关联的Group或Resource获取Environment信息，避免重复映射env_id：

import jakarta.persistence.*;
import lombok.Data;

@Entity
@Data
public class GroupResourceAllocation {
    @EmbeddedId
    private GroupResourceAllocationId id;

    private String status;

    @MapsId({"envId", "groupName"})
    @ManyToOne
    @JoinColumns({
        @JoinColumn(name = "env_id", insertable = false, updatable = false),
        @JoinColumn(name = "group_name", insertable = false, updatable = false)
    })
    private Group group;

    @MapsId({"envId", "resourceName"})
    @ManyToOne
    @JoinColumns({
        @JoinColumn(name = "env_id", insertable = false, updatable = false),
        @JoinColumn(name = "resource_name", insertable = false, updatable = false)
    })
    private Resource resource;

    // 通过关联实体间接获取Environment，无需单独映射
    public Environment getEnvironment() {
        return group.getEnvironment();
    }
}

关键说明 #

• 使用复合嵌入ID时，关联其他复合主键实体，@MapsId需指定嵌入ID中对应的所有主键字段（数组形式），让Hibernate识别这些字段对应同一列，避免冲突。
• 尽量避免同一列被多个实体字段同时映射，即使设置了不可插入/更新，仍可能触发Hibernate的重复映射检测。

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