Hibernate “对象引用未保存的瞬态实例”错误指南：如何解决和避免

Hibernate 中“对象引用未保存的瞬态实例”错误：全面指南

问题概述

在使用 Hibernate 保存对象时，可能会遇到一个常见的错误：“object references an unsaved transient instance - save the transient instance before flushing”。这个错误表明 Hibernate 试图保存一个未关联到持久化实体或尚未添加到持久化上下文中的瞬态实例。

解决方案

解决此错误的方法有多种，具体取决于代码中的情况。最常见的解决方案包括：

• 显式保存瞬态实例： 在刷新持久化上下文之前，显式保存瞬态实例。
• 级联保存： 通过启用级联保存，父实体的持久化操作将自动持久化其子实体。
• 合并瞬态实例： 将瞬态实例与持久化上下文中已存在的实体合并。

步骤指南

显式保存瞬态实例

Session session = sessionFactory.openSession();
TransientEntity entity = new TransientEntity();
entity.setName("New Entity");

session.save(entity);
session.flush();

级联保存

在父实体的映射中启用级联保存：

@Entity
public class ParentEntity {

    @OneToMany(cascade = CascadeType.ALL)
    private Set<ChildEntity> children;

    // ...
}

合并瞬态实例

Session session = sessionFactory.openSession();
TransientEntity entity = new TransientEntity();
entity.setName("New Entity");

session.merge(entity);

其他注意事项

• 确保在执行持久化操作之前打开持久化上下文的交易。
• 检查实体是否正确映射并与数据库表关联。
• 如果使用延迟加载，请确保在访问关联实体之前初始化延迟加载。
• 如果问题仍然存在，请检查数据库日志以查找潜在的额外错误。

常见问题解答

Q1：什么是瞬态实例？
A：瞬态实例是尚未持久化的对象，即它们尚未附加到持久化上下文中。

Q2：为什么会出现“对象引用未保存的瞬态实例”错误？
A：此错误通常是因为试图保存一个尚未添加到持久化上下文中的瞬态实例。

Q3：如何启用级联保存？
A：在实体映射中，使用 @OneToMany(cascade = CascadeType.ALL) 来启用级联保存。

Q4：什么时候应该合并瞬态实例？
A：当需要将瞬态实例附加到持久化上下文中的现有实体时，应该合并瞬态实例。

Q5：如何避免此错误？
A：确保在刷新持久化上下文之前保存或合并瞬态实例，并检查实体映射是否正确。