Spring Boot中save()方法执行后多对多关联关系被删除问题

核心原因 #

该问题90%以上的场景是Hibernate检测到员工实体对应的项目关联集合为空，判定该员工已解除所有项目关联，因此自动触发关联表删除操作，常见触发原因如下：

• 更新员工时未加载原有关联集合，直接使用无关联数据的实体对象执行更新
• @ManyToMany注解配置了错误的级联策略或孤儿删除属性
• 多对多的关系维护方/被维护方配置错误

具体修复方案 #

1. 修正关联注解配置 #

多对多关系需明确唯一的关系维护方，不要配置不必要的级联删除或孤儿删除属性，参考配置如下：

// Project实体（关系维护方）
@ManyToMany
@JoinTable(
    name = "project_employee",
    joinColumns = @JoinColumn(name = "project_id"),
    inverseJoinColumns = @JoinColumn(name = "employee_id")
)
private Set<Employee> employees = new HashSet<>();

// Employee实体（关系被维护方）
@ManyToMany(mappedBy = "employees", cascade = {CascadeType.PERSIST, CascadeType.MERGE})
private Set<Project> projects = new HashSet<>();

注意：禁止给多对多关联配置CascadeType.REMOVE或orphanRemoval = true，避免误删关联记录甚至实体本身。

2. 更新操作保留原有关联集合 #

更新员工基本信息时，先查询数据库中完整的员工实体（包含关联的项目集合），仅修改需要更新的字段，不要覆盖或清空关联集合，参考代码：

@Transactional
public Employee updateEmployee(Long empId, EmployeeUpdateReq req) {
    // 先查询已有实体，自动加载关联的projects集合
    Employee emp = employeeRepository.findById(empId)
        .orElseThrow(() -> new IllegalArgumentException("员工不存在"));
    // 仅更新需要修改的字段，不触碰projects关联集合
    emp.setFirstName(req.getFirstName());
    emp.setLastName(req.getLastName());
    emp.setEmail(req.getEmail());
    return employeeRepository.save(emp);
}

如果使用DTO转实体工具，需显式配置排除关联集合的覆盖逻辑，避免转换后关联集合被置空。

3. 特殊场景可选配置 #

如果业务上更新员工信息时完全不需要操作项目关联，可以在@ManyToMany注解上添加insertable = false, updatable = false（仅在被维护方配置），禁止该侧关联关系的级联修改。

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