Hibernate多对多关联更新时无法移除旧关系的问题

问题根源 #

1. 多对多维护端限制：你的多对多关联中，Permission是被动端（@ManyToMany标注了mappedBy="permissions"），只有维护端Role的集合变更才会同步到关联表roles_permissions。直接修改被动端的集合不会触发关联表的删除操作。
2. 更新逻辑缺陷：当前直接将DTO转为新实体保存，没有加载数据库中已有的持久化实体，Hibernate无法识别需要删除旧关联。
3. Mapper方法错误：PermissionMapper的assignPermissionToRoles方法直接用当前Permission替换了Role的所有权限集合，既破坏了角色原有权限，也未处理旧关联的移除。

具体解决方案 #

1. 修正Permission更新逻辑 #

更新时先加载数据库中已有的持久化实体，手动处理关联关系的移除与添加：

public PermissionDto update(@Valid PermissionDto permissionDto) {
    // 加载数据库中已存在的Permission（持久化状态）
    Permission existingPermission = permissionRepository.findById(permissionDto.getId())
            .orElseThrow(() -> new ResourceNotFoundException("Permission not found"));
    
    // 合并基础字段
    existingPermission.setCode(permissionDto.getCode());
    existingPermission.setActive(permissionDto.isActive());
    
    // 获取新的角色集合
    Set<Role> newRoles = roleRepository.findAllById(permissionDto.getRolesIds());
    
    // 移除旧关联：从原角色的权限集合中删除当前Permission
    existingPermission.getRoles().forEach(oldRole -> 
            oldRole.getPermissions().remove(existingPermission));
    
    // 清空当前Permission的旧角色关联
    existingPermission.getRoles().clear();
    
    // 添加新关联：将当前Permission加入新角色的权限集合
    newRoles.forEach(newRole -> {
        newRole.getPermissions().add(existingPermission);
        existingPermission.getRoles().add(newRole);
    });
    
    // 保存更新后的实体
    Permission updatedPermission = permissionRepository.save(existingPermission);
    return permissionMapper.toDto(updatedPermission);
}

2. 修正PermissionMapper的错误逻辑 #

删除原有的assignPermissionToRoles方法，避免破坏角色权限：

@Mapper(componentModel = "spring",
        unmappedTargetPolicy = ReportingPolicy.WARN,
        builder = @Builder(disableBuilder = true),
        uses = RoleMapper.class)
public interface PermissionMapper extends EntityMapper<Permission, PermissionDto> {

    @Override
    @Mapping(source = "rolesIds", target = "roles")
    Permission toEntity(PermissionDto dto);

    @Override
    @Mapping(source = "roles", target = "rolesIds")
    PermissionDto toDto(Permission entity);

    // 移除原有的assignPermissionToRoles方法
}

3. 关键说明 #

• 必须操作维护端Role的permissions集合，才能让Hibernate同步关联表的删除/插入操作。
• 使用从数据库加载的持久化实体，Hibernate的脏检查机制才能正确识别集合变更。
• 手动处理旧关联移除和新关联添加，确保关联表数据与业务需求完全一致。

内容的提问来源于stack exchange，提问作者dev-rifaii