Hibernate在@ManyToOne关联中忽略@MapsId仍尝试持久化父实体

问题背景 #

在JPA中定义了Absence、AbsenceAffectation、Branch三个实体，其中AbsenceAffectation作为Absence、User、Branch的关联表，通过复合主键+@MapsId映射关联关系。保存Absence时触发如下错误：

org.springframework.dao.DuplicateKeyException: A different object with the same identifier value was already associated with the session : [Branch#tsthww5]

调试发现，即便使用了@MapsId，Hibernate仍试图持久化AbsenceAffectation关联的Branch实体（该Branch已通过persistRelations存入会话），需要实现仅存储Branch的code，阻止Hibernate持久化该关联Branch实体。

可行解决方案 #

方案1：给@ManyToOne添加只读标记（Hibernate专属） #

在AbsenceAffectation类中，对Branch的@ManyToOne注解添加@ReadOnlyProperty，明确告知Hibernate不对该关联实体执行持久化操作：

@ManyToOne
@ReadOnlyProperty
@MapsId("branchCode") // 对应复合主键中的branchCode字段
private Branch branch;

方案2：将关联Branch设为游离状态 #

如果不想依赖Hibernate专属注解，可以先把已存在的Branch从会话中剥离（设为游离状态），再关联到AbsenceAffectation：

// 获取已存在的Branch并从会话中分离
Branch existingBranch = entityManager.find(Branch.class, "tsthww5");
entityManager.detach(existingBranch);

// 关联游离状态的Branch到AbsenceAffectation
absenceAffectation.setBranch(existingBranch);

同时建议将@ManyToOne设置为懒加载：

@ManyToOne(fetch = FetchType.LAZY)
@MapsId("branchCode")
private Branch branch;

方案3：直接存储Branch的code而非实体关联（推荐） #

如果业务上仅需存储Branch的code，可以在AbsenceAffectation的复合主键类中直接定义branchCode字段，实体类中不再关联完整的Branch实体：

// 复合主键类
public class AbsenceAffectationId implements Serializable {
    private Long absenceId;
    private Long userId;
    private String branchCode; // 直接存储Branch的code
    // 实现构造器、equals、hashCode方法
}

// AbsenceAffectation实体类
@Entity
@IdClass(AbsenceAffectationId.class)
public class AbsenceAffectation {
    @Id
    private Long absenceId;
    @Id
    private Long userId;
    @Id
    private String branchCode;

    // 可选：若需偶尔关联Branch实体，可添加以下配置（不参与增改）
    @ManyToOne
    @JoinColumn(name = "branch_code", insertable = false, updatable = false)
    private Branch branch;

    // 其他字段与关联关系
}

这种方式从根源上避免了Hibernate尝试持久化关联Branch的问题，因为我们仅存储ID值而非实体引用。

原理说明 #

• @MapsId仅负责将关联实体的ID映射到当前实体的主键字段，不会自动阻止Hibernate对关联实体的持久化行为，尤其是当关联实体处于会话上下文时。
• 上述方案的核心都是告知Hibernate：该关联实体的状态无需被当前操作修改或持久化，仅需使用其ID完成关联映射即可。

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