如何在Quarkus框架中处理Hibernate多对多关系重复数据及脱管实体报错

• 级联配置不合理：Fruit的categories字段上配置了CascadeType.PERSIST，当保存Fruit时会触发对关联Category的持久化操作，如果关联的Category是已存在的游离态实体，就会触发detached entity passed to persist报错。
• 关联维护端错位：Fruit的@ManyToMany注解加了mappedBy = "fruits"，意味着关联关系的维护权在Category侧，仅修改Fruit的categories集合无法同步中间表，在setter中强制修改Category的fruits集合反而会增加持久化逻辑的混乱。
• 实体职责越界：在实体类的setter方法中执行数据库查询操作，脱离事务上下文查询得到的实体默认是游离态，同时也违反了实体类作为POJO的设计原则。

1. 修正实体类关联配置 #

Fruit.java #

package org.acme.hibernate.orm.panache;

import io.quarkus.hibernate.orm.panache.PanacheEntity;

import javax.persistence.*;
import java.util.List;

@Entity
@Cacheable
public class Fruit extends PanacheEntity {

  @Column(length = 40, unique = true)
  public String name;

  // 去掉mappedBy，Fruit作为关联关系的维护端，显式配置中间表
  @ManyToMany(cascade = { CascadeType.MERGE })
  @JoinTable(
    name = "fruit_category",
    joinColumns = @JoinColumn(name = "fruit_id"),
    inverseJoinColumns = @JoinColumn(name = "category_id")
  )
  public List<Category> categories;

  public Fruit () {
  }

  public Fruit (String name) {
    this.name = name;
  }

  // 移除setter中的数据库查询逻辑，仅保留基础赋值操作
  public void setCategories (List<Category> categories) {
    this.categories = categories;
  }
}

Category.java #

package org.acme.hibernate.orm.panache;

import io.quarkus.hibernate.orm.panache.PanacheEntity;

import javax.persistence.*;
import java.util.List;

@Entity
@Cacheable
public class Category extends PanacheEntity {
  @Column(length = 40, unique = true)
  public String name;

  // 增加mappedBy，作为关联关系的被维护端，移除不必要的级联配置
  @ManyToMany(mappedBy = "categories")
  public List<Fruit> fruits;

  public Category() {
  }

  public Category(String name) {
    this.name = name;
  }
}

2. 编写事务性业务逻辑处理关联保存 #

将关联校验、查询逻辑放到事务性的Service层执行，保证所有实体操作都在持久化上下文中完成：

package org.acme.hibernate.orm.panache.service;

import io.quarkus.panache.common.Parameters;
import org.acme.hibernate.orm.panache.Category;
import org.acme.hibernate.orm.panache.Fruit;

import javax.enterprise.context.ApplicationScoped;
import javax.transaction.Transactional;
import java.util.List;
import java.util.Objects;
import java.util.stream.Collectors;

@ApplicationScoped
public class FruitService {

  // 所有数据库操作都在事务上下文中执行，避免出现游离态实体
  @Transactional
  public Fruit saveFruitWithCategories(Fruit fruit) {
    // 统一处理分类关联逻辑
    List<Category> handledCategories = fruit.categories.stream().map(category -> {
      Category existCategory = Category.find("name = :name", Parameters.with("name", category.name)).firstResult();
      if (existCategory != null) {
        // 事务内查询得到的是持久态实体，可直接关联
        return existCategory;
      }
      // 新增分类先单独持久化
      category.persist();
      return category;
    }).filter(Objects::nonNull).collect(Collectors.toList());

    fruit.setCategories(handledCategories);
    // 作为维护端的Fruit保存时，会自动同步中间表数据
    fruit.persist();
    return fruit;
  }
}

该方案的核心优势：

• 关联关系维护逻辑清晰，仅修改维护端属性即可同步中间表，无需修改被维护端的集合属性
• 所有数据库操作都在事务内执行，避免出现游离态实体
• 级联配置仅保留必要的MERGE，不会触发不必要的实体持久化操作
• 实体类和数据访问逻辑解耦，符合POJO的设计规范

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