Hibernate 5升级至6后refresh方法抛出TransientObjectException求助

问题概述 #

升级Hibernate至6版本后，执行persist→flush→refresh流程抛出org.hibernate.TransientObjectException: Instance was not associated with this persistence context异常；移除refresh后仅ID能正确加载，其他数据库生成字段（如默认值、触发器字段）无法同步；merge方案会覆盖数据触发NULL约束，清空EntityManager存在未知副作用，且仅PostgreSQL出现该问题，H2测试正常。

可行解决方案 #

1. 适配PostgreSQL的ID生成策略 #

Hibernate 6对标识符生成逻辑做了重构，PostgreSQL下原ID策略可能导致实体未正确关联持久化上下文：

• 优先使用SEQUENCE策略替代IDENTITY（PostgreSQL原生支持序列，兼容性更好）：

@Id
@GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "your_entity_seq")
@SequenceGenerator(name = "your_entity_seq", sequenceName = "your_entity_id_seq", allocationSize = 1)
private Long id;

• 若坚持使用IDENTITY，需确保数据库列类型为SERIAL/BIGSERIAL，同时检查Hibernate配置是否开启了PostgreSQL的IDENTITY适配。

2. 移除refresh，直接通过find加载最新实例 #

flush后数据库已写入数据，find操作会从持久化上下文或数据库获取关联的实例，自动同步所有字段：

public <T extends IdentifiableObject> T create(T t) {
    this.entityManager.persist(t);
    this.entityManager.flush();
    Object primaryKey = t.getId();
    // 直接返回find结果，无需额外refresh
    return (T) this.entityManager.find(t.getClass(), primaryKey);
}

3. 启用旧版标识符生成兼容模式 #

通过配置回退到Hibernate 5的标识符生成逻辑，快速解决上下文关联问题（长期建议逐步适配新版策略）：

# Spring Boot环境配置
spring.jpa.properties.hibernate.id.new_generator_mappings=false

# 原生JPA persistence.xml配置
<property name="hibernate.id.new_generator_mappings" value="false"/>

4. 确认事务边界有效性 #

确保create方法在事务上下文内执行：

• Spring环境添加@Transactional注解：

@Transactional
public <T extends IdentifiableObject> T create(T t) {
    this.entityManager.persist(t);
    this.entityManager.flush();
    this.entityManager.refresh(t);
    return t;
}

• 非Spring环境需手动管理事务，保证persist、flush、refresh操作在同一事务内完成。

差异原因说明 #

Hibernate对不同数据库的标识符生成适配逻辑不同：H2的IDENTITY处理较为宽松，实体flush后会自动关联到持久化上下文；而PostgreSQL在Hibernate 6下对序列/自增列的关联校验更严格，若ID策略不匹配，会导致flush后实体脱离上下文，触发refresh异常。

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