JPA(Hibernate) ManyToMany保存时中间表无关联记录问题咨询

• JPA多对多关联中，配置了mappedBy属性的一侧为关系被维护端，不负责中间表的持久化操作。当前代码中Group实体的users字段标记了mappedBy = "groups"，说明中间表GROUP_USER_RELATIONSHIP的写入完全由User实体的groups集合控制。代码仅在Group侧的users集合中添加了用户，未同步更新负责维护关联关系的User.groups集合，因此JPA不会向中间表插入关联记录。
• 之前双向同步触发无限循环，是因为两个实体的关联添加方法互相调用，且未做存在性校验：Group.addUser调用User.addGroup，User.addGroup又反向调用Group.addUser，最终导致栈溢出。
• 现有配置存在额外风险：多对多关联两侧都配置了CascadeType.ALL，后续执行删除操作时会级联删除关联的另一侧实体，比如删除一个用户组时会连带删除组内所有用户，不符合常规业务预期。

第一步：修正实体关联逻辑，统一关联维护入口 #

将双向关联的同步逻辑统一收口到Group侧的关联方法中，添加存在性校验避免重复操作和无限循环，同时调整不合理的级联配置：

// Group实体核心修正部分
@ManyToOne
User administrator;
// 被维护端不要配置CascadeType.ALL，避免误删关联用户
@ManyToMany(mappedBy = "groups")
Set<User> users = new HashSet<>();

public void setAdministrator(User user){
    this.administrator = user;
    addUser(user);
}

public void addUser(User user){
    // 已存在关联直接返回，避免重复操作和循环调用
    if (this.users.contains(user)) {
        return;
    }
    this.users.add(user);
    // 同步更新关系维护端的集合，保证双向关联一致
    user.getGroups().add(this);
}

// User实体核心修正部分
// 关系维护端仅配置业务需要的级联项，不要配置REMOVE/ALL
@ManyToMany(cascade = {CascadeType.PERSIST, CascadeType.MERGE})
@JoinTable(
        name = "GROUP_USER_RELATIONSHIP",
        joinColumns = @JoinColumn(name = "user_id"),
        inverseJoinColumns = @JoinColumn(name = "group_id"))
Set<Group> groups = new HashSet<>();

// 不要在该方法中反向调用Group.addUser，所有关联同步逻辑统一由Group侧处理
public void addGroup(Group group){
    if (this.groups.contains(group)) {
        return;
    }
    this.groups.add(group);
}

第二步：修正业务层持久化逻辑 #

由于多对多关系由User侧维护，持久化时需要保证维护端实体的关联集合更新被同步到数据库：

@Override
public Group createGroup(String userEmail, String groupName) {
    User userInDb = userRepository.findUserByEmailIgnoreCase(userEmail)
            .orElseThrow(() -> new UserNotFoundException(userEmail));

    // 重名校验逻辑保持不变
    userInDb.getGroups().stream()
            .filter(group -> group.getName().equals(groupName))
            .findAny()
            .ifPresent(existGroup -> {
                throw new GroupUniqueConstrainException(existGroup.getName());
            });

    Group newGroup = new Group();
    newGroup.setName(groupName);
    // setAdministrator内部会自动完成双向关联同步，将newGroup加入userInDb的groups集合
    newGroup.setAdministrator(userInDb);

    groupRepository.save(newGroup);
    // 保存关系维护端User，触发中间表关联记录插入
    userRepository.save(userInDb);
    return newGroup;
}

注意：双向JPA关联的维护逻辑必须统一在单侧实现，禁止两侧关联方法互相调用；每次添加关联前先做存在性判断，既可以避免无限递归，也能防止重复插入中间表数据。多对多场景下非必要不要配置CascadeType.ALL，避免级联删除导致的数据误删问题。

内容的提问来源于stack exchange，提问作者Jakub Znamenáček