Hibernate中@ManyToMany映射更新时触发删除而非更新的问题

问题场景 #

UserWorkRelatedInfo 实体的关联字段代码如下：

@JsonBackReference
@ManyToMany(fetch = FetchType.LAZY)
@JoinTable(name = "user_work_related_info_roles",
        joinColumns = @JoinColumn(name = "user_work_related_info_id"),
        inverseJoinColumns = @JoinColumn(name = "role_id"))
private Set<Role> roles;

Role 实体未配置任何反向关联映射。

Hibernate 执行日志 #

Hibernate: 
    update
        user_work_related_info 
    set
        handover_protocol_id=?,
        lead_id=?,
        position_id=?,
        stack=?,
        user_id=? 
    where
        id=?
2023-08-03 12:50:02.127  INFO 66838 --- [0.0-8080-exec-2] e.g.erp.utils.audit.CrudEventListener    : Admin updated UserWorkRelatedInfo : {"id":11,"stack":null,"position":null,"handoverProtocol":null}
Hibernate: 
    delete 
    from
        user_work_related_info_roles 
    where
        user_work_related_info_id=?

问题现象 #

仅更新 UserWorkRelatedInfo 实体的 lead 字段时，关联的中间表 user_work_related_info_roles 会被执行全量删除操作，这与预期不符（预期中间表不应被修改）。

已尝试的无效操作 #

• 重写 Role 和 UserWorkRelatedInfo 的 equals()、hashCode() 方法
• 在 Role 实体中添加 mappedBy 配置双向关联
• 移除 User 实体的 orphanRemoval 属性
• 修改关联的级联类型
• 使用实体图进行关联查询

核心原因 #

问题根源在于懒加载机制：当加载 UserWorkRelatedInfo 实体时，roles 集合是未初始化的代理对象。如果更新操作时没有显式初始化这个集合，Hibernate 会将其判定为空集合，进而触发中间表的全量删除。

修复步骤 #

1. 更新前确保关联集合被初始化
   在执行更新前，通过主动触发懒加载或查询时关联加载的方式，确保 roles 集合被正确初始化：

   // 方式1：主动触发懒加载
   UserWorkRelatedInfo entity = entityManager.find(UserWorkRelatedInfo.class, id);
   entity.getRoles().size(); // 触发懒加载，初始化集合
   
   // 方式2：查询时JOIN FETCH加载集合
   UserWorkRelatedInfo entity = entityManager.createQuery(
       "SELECT u FROM UserWorkRelatedInfo u JOIN FETCH u.roles WHERE u.id = :id",
       UserWorkRelatedInfo.class
   )
   .setParameter("id", id)
   .getSingleResult();
   

2. 排查更新逻辑是否误操作集合
   检查业务代码中，是否在更新 lead 字段时无意中修改了 roles 集合，比如执行了 setRoles(null)、getRoles().clear() 这类操作，这类操作会直接触发Hibernate对中间表的删除。

3. 明确级联策略（可选）
   如果不需要在更新 UserWorkRelatedInfo 时同步维护 roles 关联，可明确设置级联类型，避免不必要的关联操作：

   @ManyToMany(fetch = FetchType.LAZY, cascade = {CascadeType.PERSIST, CascadeType.MERGE})
   @JoinTable(name = "user_work_related_info_roles",
           joinColumns = @JoinColumn(name = "user_work_related_info_id"),
           inverseJoinColumns = @JoinColumn(name = "role_id"))
   private Set<Role> roles;
   

4. 维护双向关联一致性（若启用双向关联）
   如果已经在 Role 实体中配置了 mappedBy，需确保关联操作时同时维护双方集合：

   // UserWorkRelatedInfo 中的关联维护方法
   public void addRole(Role role) {
       this.roles.add(role);
       role.getUserWorkRelatedInfos().add(this);
   }
   
   public void removeRole(Role role) {
       this.roles.remove(role);
       role.getUserWorkRelatedInfos().remove(this);
   }
   

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