Spring多对多含额外字段报错：detached entity passed to persist

错误原因 #

出现detached entity passed to persist的核心原因：

1. KoktelSastojak的复合主键KoktelSastojakKey未被正确初始化，JPA无法识别该关联实体的状态；
2. 若DAO的saveKoktelSastojak使用entityManager.persist()，该方法仅适用于全新无主键实体，而关联的Koktel和Sastojak已拥有主键，导致JPA误判实体状态。

修复步骤 #

1. 修正KoktelSastojak构造函数 #

在构造函数中同步初始化复合主键的字段，确保JPA能正确识别实体关联关系：

public KoktelSastojak(Koktel koktel, Sastojak sastojak, float kolicina, String mernaJedinica) {
    this.koktel = koktel;
    this.sastojak = sastojak;
    // 同步设置复合主键的ID值
    this.id.setKoktelId(koktel.getId());
    this.id.setSastojakId(sastojak.getId());
    this.kolicina = kolicina;
    this.mernaJedinica = mernaJedinica;
}

2. 检查DAO的save方法实现 #

• 若使用Spring Data JPA的JpaRepository，直接用默认save()方法即可，它会自动判断实体状态（新实体用persist，已有主键用merge）；
• 若自定义DAO实现，需将entityManager.persist()替换为entityManager.merge()，支持关联已有主键实体的保存。

3. 简化实体保存逻辑 #

无需在save后手动fetch实体，Spring JPA的save()方法会返回持久化后的实体，直接使用返回值即可保证实体处于持久化上下文：

// 替换原有的save+findById逻辑
tmpKoktel = appDAO.saveKoktel(tmpKoktel);

// Sastojak同理
tmpSastojak1 = appDAO.saveSastojak(tmpSastojak1);
tmpSastojak2 = appDAO.saveSastojak(tmpSastojak2);
tmpSastojak3 = appDAO.saveSastojak(tmpSastojak3);

最佳实践 #

1. 完善复合主键类
   确保KoktelSastojakKey实现Serializable接口，并重写equals()和hashCode()方法，这是JPA复合主键的强制要求：

@Embeddable
public class KoktelSastojakKey implements Serializable {
    @Column(name = "koktel_id")
    private Long koktelId;
    @Column(name = "sastojak_id")
    private Long sastojakId;

    // 构造函数、getter、setter
    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        KoktelSastojakKey that = (KoktelSastojakKey) o;
        return Objects.equals(koktelId, that.koktelId) && Objects.equals(sastojakId, that.sastojakId);
    }

    @Override
    public int hashCode() {
        return Objects.hash(koktelId, sastojakId);
    }
}

2. 添加双向关联（可选但推荐）
   在Koktel和Sastojak实体中添加与KoktelSastojak的双向关联，方便后续查询操作：

// Koktel实体中添加
@OneToMany(mappedBy = "koktel", cascade = CascadeType.ALL, orphanRemoval = true)
private List<KoktelSastojak> sastojci = new ArrayList<>();

// 提供添加关联的方法
public void addSastojak(Sastojak sastojak, float kolicina, String mernaJedinica) {
    KoktelSastojak assoc = new KoktelSastojak(this, sastojak, kolicina, mernaJedinica);
    sastojci.add(assoc);
    sastojak.getKokteli().add(assoc);
}

// Sastojak实体中添加
@OneToMany(mappedBy = "sastojak", cascade = CascadeType.ALL, orphanRemoval = true)
private List<KoktelSastojak> kokteli = new ArrayList<>();

3. 使用事务管理
   在createKoktelAndSastojci方法上添加@Transactional注解，确保所有操作在同一个事务中执行，避免实体游离：

@Transactional
private void createKoktelAndSastojci(AppDAO appDAO) {
    // 原有逻辑...
}

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