解决`detached entity passed to persist`错误：实体关联注解是否需调整？

我遇到了org.hibernate.PersistentObjectException转换为JPA PersistenceException的错误：detached entity passed to persist，不清楚问题所在，查阅部分解决方案但未找到适配方法。

我在数据库中创建了PropertyOwner、Property、Repair三张表，希望关联它们的ID。执行以下代码时触发错误，但单独插入或更新实体时无异常：

properties.get(0).setOwner(propertyOwners.get(0));
properties.get(1).setOwner(propertyOwners.get(1));

repairs.get(0).setProperty(properties.get(0));
repairs.get(1).setProperty(properties.get(1));

repairs.get(0).setOwner(propertyOwners.get(0));
repairs.get(1).setOwner(propertyOwners.get(1));

以下是我的实体类代码：

Persistent.Class #

@Data
@NoArgsConstructor
@MappedSuperclass
public class PersistentClass {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private int id;
}

PropertyOwner.class #

@Data
@NoArgsConstructor
@Entity
@Table(name = "propertyowner")
public class PropertyOwner extends PersistentClass {

  private int vat;
  private String name;
  private String surname;
  private String address;
  private String phoneNumber;
  private String email;
  private String username;
  private String password;
  @OneToMany(mappedBy = "owner", cascade = CascadeType.ALL, orphanRemoval = true)
  private List<Property> properties;

  public PropertyOwner(int vat, String name, String surname, String address, String phoneNumber, String email, String username, String password) {
    this.vat = vat;
    this.name = name;
    this.surname = surname;
    this.address = address;
    this.phoneNumber = phoneNumber;
    this.email = email;
    this.username = username;
    this.password = password;
  }

}

Property.class #

@Data
@NoArgsConstructor
@Entity
@Table(name = "property")
public class Property extends PersistentClass {

  private int e9;
  private String address;
  private String yearOfConstruction;
  @Enumerated(EnumType.STRING)
  private PropertyType propertyType;
  @ManyToOne
  @Cascade(org.hibernate.annotations.CascadeType.ALL)
  @JoinColumn(name = "owner_id")
  private PropertyOwner owner;

  @OneToMany(mappedBy = "property", cascade = CascadeType.ALL, orphanRemoval = true)
  private List<Repair> repairs;

  public Property(int e9, String address, String yearOfConstruction, PropertyType propertyType) {
    this.e9 = e9;
    this.address = address;
    this.yearOfConstruction = yearOfConstruction;
    this.propertyType = propertyType;
  }
}

Repair.class #

@Data
@NoArgsConstructor
@Entity
@Table(name = "repair")
public class Repair extends PersistentClass {

  @ManyToOne
  @Cascade(org.hibernate.annotations.CascadeType.ALL)
  @JoinColumn(name = "owner_id")
  private PropertyOwner owner;
  @ManyToOne
  @Cascade(org.hibernate.annotations.CascadeType.ALL)
  @JoinColumn(name = "property_id")
  private Property property;
  @Enumerated(EnumType.STRING)
  private RepairType repairType;
  private String repairDescription;
  private LocalDate submissionDate;
  private String workDescription;
  private LocalDate startDate;
  private LocalDate endDate;
  private double cost;
  private boolean acceptance;
  @Enumerated(EnumType.STRING)
  private RepairStatus repairStatus;
  private LocalDate actualStartDate;
  private LocalDate actualEndDate;

  public Repair(String repairDescription, LocalDate submissionDate, LocalDate startDate, double cost, boolean acceptance, RepairStatus repairStatus) {
    this.repairDescription = repairDescription;
    this.submissionDate = submissionDate;
    this.startDate = startDate;
    this.cost = cost;
    this.acceptance = acceptance;
    this.repairStatus = repairStatus;

  }

}

请问是否需要修改注解？

错误核心 #

detached entity passed to persist错误本质是：你试图用persist()方法保存一个已经脱离持久化上下文的实体（即已有数据库ID的实体），但persist()仅适用于全新、未分配ID的实体。你的问题源于级联操作冲突和双向关联未完整维护：

1. Property和Repair都对PropertyOwner设置了@Cascade(org.hibernate.annotations.CascadeType.ALL)，当同时关联同一个PropertyOwner时，Hibernate会重复处理已存在的实体，触发分离实体错误。
2. 双向关联仅维护了单向关系（如Property.setOwner()），未同步更新PropertyOwner的properties集合，导致持久化上下文状态不一致。

具体修改步骤 #

1. 调整级联注解，避免重复级联

• Property.class：将Hibernate的@Cascade替换为JPA标准的cascade = CascadeType.MERGE（PropertyOwner通常先创建，关联时仅需合并更新，无需级联新建/删除）：

@ManyToOne(cascade = CascadeType.MERGE)
@JoinColumn(name = "owner_id")
private PropertyOwner owner;

• Repair.class：同样修改PropertyOwner和Property的级联规则为CascadeType.MERGE：

@ManyToOne(cascade = CascadeType.MERGE)
@JoinColumn(name = "owner_id")
private PropertyOwner owner;

@ManyToOne(cascade = CascadeType.MERGE)
@JoinColumn(name = "property_id")
private Property property;

注：若业务需通过Property新建PropertyOwner，可保留CascadeType.PERSIST，但不要用ALL，避免不必要的级联操作引发冲突。

2. 维护双向关联的完整性

设置关联时同步更新双向集合：

// 关联Property与Owner
PropertyOwner owner0 = propertyOwners.get(0);
Property prop0 = properties.get(0);
prop0.setOwner(owner0);
if (owner0.getProperties() == null) {
    owner0.setProperties(new ArrayList<>());
}
owner0.getProperties().add(prop0);

PropertyOwner owner1 = propertyOwners.get(1);
Property prop1 = properties.get(1);
prop1.setOwner(owner1);
if (owner1.getProperties() == null) {
    owner1.setProperties(new ArrayList<>());
}
owner1.getProperties().add(prop1);

// 关联Repair与Property、Owner
Repair repair0 = repairs.get(0);
repair0.setProperty(prop0);
repair0.setOwner(owner0);
if (prop0.getRepairs() == null) {
    prop0.setRepairs(new ArrayList<>());
}
prop0.getRepairs().add(repair0);

Repair repair1 = repairs.get(1);
repair1.setProperty(prop1);
repair1.setOwner(owner1);
if (prop1.getRepairs() == null) {
    prop1.setRepairs(new ArrayList<>());
}
prop1.getRepairs().add(repair1);

3. 确保操作在同一持久化上下文执行

若propertyOwners、properties、repairs是从数据库查询的，需确保它们处于同一个EntityManager上下文内；若为离线实体，需先调用entityManager.merge()将其重新纳入上下文，再进行关联操作。

关键注意点 #

• 优先使用JPA标准的cascade属性，避免混合Hibernate的@Cascade注解，减少兼容性问题。
• 双向关联必须同时维护双方关系，否则会导致持久化上下文状态不一致，引发异常。
• persist()用于新实体，merge()用于更新已存在的实体，不可混用。

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