运行测试时遇detached entity passed to persist异常求助（SpringData+Hibernate）

这个问题我之前在Spring Data JPA项目里踩过坑，核心原因很明确：你调用persist()（包括Spring Data的save()底层可能触发的persist）时传入了一个「游离态（detached）」的实体对象——Hibernate的persist()方法只能处理全新的「瞬时态（transient）」对象（也就是还没被持久化、没有主键值或者主键值未被Hibernate认可的对象），而不能处理已经拥有有效持久化标识（比如已经从数据库查询过、主键已存在）的游离对象。

结合你的场景（用了@ElementCollection，关联了Company实体），大概率是这几个原因导致的：

• 你关联到Invoice的Company对象，之前已经被持久化过（比如从数据库查询出来后脱离了当前的EntityManager上下文），现在它处于游离态，当你保存Invoice时，Hibernate尝试持久化整个关联链，就会报错。
• 可能你误用了@ElementCollection：这个注解是用来映射值类型集合（比如@Embeddable的嵌入类），如果InvoiceEntry本身是@Entity实体类，那应该用@OneToMany而不是@ElementCollection，否则Hibernate对集合内的实体状态处理会混乱。

下面是具体的解决办法：

1. 改用merge()代替persist() #

如果你的Invoice或者关联的Company已经是游离态，不要用persist()，改用merge()方法——它会把游离态的对象合并到当前持久化上下文，自动处理状态同步。
用Spring Data JPA的话，默认的save()方法其实会根据对象状态自动选择persist或merge，但如果因为代理或者上下文问题失效，可以手动调用EntityManager的merge：

// 示例代码
Company existingCompany = companyRepository.findById(1L).orElseThrow();
Invoice invoice = new Invoice();
invoice.getProducts().add(new InvoiceEntry(existingCompany));

// 手动调用merge
entityManager.merge(invoice);

2. 确保关联实体处于持久态 #

在把Company关联到Invoice之前，先把它加载到当前的持久化上下文里，变成「持久态（managed）」对象。比如重新通过Repository查询一次：

// 重新查询，确保Company处于当前EntityManager上下文
Company managedCompany = companyRepository.findById(existingCompany.getId()).orElseThrow();
Invoice invoice = new Invoice();
invoice.getProducts().add(new InvoiceEntry(managedCompany));
// 这时候调用persist/save就不会报错
invoiceRepository.save(invoice);

3. 检查@ElementCollection的使用是否正确 #

如果InvoiceEntry是一个独立的实体类（带有@Entity注解），那你不能用@ElementCollection，应该换成@OneToMany映射，同时配置合适的级联策略：

@Entity
@Proxy(lazy = false)
public class Invoice {
    // 替换@ElementCollection为@OneToMany，配置级联
    @OneToMany(cascade = {CascadeType.PERSIST, CascadeType.MERGE}, fetch = FetchType.EAGER)
    private List<InvoiceEntry> products;
    // ...其他字段和方法
}

// 确保InvoiceEntry是实体类
@Entity
public class InvoiceEntry {
    @ManyToOne
    private Company company;
    // ...其他字段和方法
}

如果InvoiceEntry确实是值类型（@Embeddable），那要确保它里面关联的Company是持久态，否则同样会触发游离态错误。

4. 检查主键生成策略 #

如果Company的主键是手动赋值的（而不是Hibernate自动生成，比如@GeneratedValue），那新建的Company对象如果已经有主键值，Hibernate会默认认为它是游离态。这种情况下，要么改用自动生成主键，要么对这类对象使用merge()而不是persist()。

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