Hibernate 6迁移：跨SQLite数据库复制实体时的持久化异常问题

根源定位 #

1. TransientObjectException 触发原因 #

从主库分离的ChildEntity在归档EntityManager中属于游离状态，当通过ParentEntity的级联MERGE操作处理关联时，Hibernate 6对带ID的游离实体处理逻辑发生变化：

• 若归档库中不存在该ChildEntity，Hibernate 6会尝试执行更新操作（而非Hibernate 5中的插入），因找不到对应记录抛出异常；
• 父子实体携带的主库@Version值，进一步干扰了归档库的持久化校验逻辑。

2. OptimisticLockException 触发原因 #

当归档库中已存在同ID的实体时，主库传来的version值与归档库本地版本不匹配，触发Hibernate 6默认的乐观锁校验机制，导致异常。

可行解决方案 #

方案一：手动管控关联实体持久化（推荐，符合JPA标准） #

先单独处理ChildEntity，确保其在归档库中正确存在后，再关联到ParentEntity，避免级联操作的不确定性：

@Service
public class Archiver {
    @Autowired
    @Qualifier("archiveEntityManager")
    private EntityManager archiveEntityManager;

    @Transactional(value = "archiveCreationTransactionManager")
    public void archiveEntities(List<ParentEntity> detachedEntities) {
        for (ParentEntity entity : detachedEntities) {
            ChildEntity detachedChild = entity.getChild();
            // 处理ChildEntity
            ChildEntity managedChild = archiveEntityManager.find(ChildEntity.class, detachedChild.getId());
            if (managedChild != null) {
                // 覆盖字段，可选择保留归档库版本或用主库版本
                managedChild.setName(detachedChild.getName());
                // 强制使用主库版本：managedChild.setVersion(detachedChild.getVersion());
            } else {
                // 归档库不存在，重置版本后持久化（按需保留主库版本）
                detachedChild.setVersion(0);
                managedChild = archiveEntityManager.merge(detachedChild);
            }

            // 处理ParentEntity
            ParentEntity existingParent = archiveEntityManager.find(ParentEntity.class, entity.getId());
            if (existingParent != null) {
                existingParent.setChild(managedChild);
                // 按需覆盖其他字段或版本
            } else {
                entity.setChild(managedChild);
                entity.setVersion(0);
                existingParent = archiveEntityManager.merge(entity);
            }
        }
    }
}

方案二：调整级联策略与分离逻辑 #

• 移除ParentEntity中@ManyToOne的CascadeType.MERGE，避免自动级联引发的游离实体异常；
• 分离实体时清空version字段，绕过归档库的乐观锁校验：

// CollectorService 修改后的分离逻辑
entities.forEach(entity -> {
    Hibernate.initialize(entity.getChild());
    // 清空版本字段，避免归档时的乐观锁冲突
    entity.setVersion(0);
    entity.getChild().setVersion(0);
    mainEntityManager.detach(entity);
    mainEntityManager.detach(entity.getChild());
});

方案三：使用Hibernate原生Session兼容旧逻辑 #

若希望沿用类似Hibernate 5的处理方式，可通过EntityManager获取Hibernate Session，使用saveOrUpdate方法（对游离实体处理更宽松）：

@Service
public class Archiver {
    @Autowired
    @Qualifier("archiveEntityManager")
    private EntityManager archiveEntityManager;

    @Transactional(value = "archiveCreationTransactionManager")
    public void archiveEntities(List<ParentEntity> detachedEntities) {
        Session session = archiveEntityManager.unwrap(Session.class);
        for (ParentEntity entity : detachedEntities) {
            // 先持久化Child，再处理Parent
            session.saveOrUpdate(entity.getChild());
            session.saveOrUpdate(entity);
        }
    }
}

注意：saveOrUpdate是Hibernate专属API，非JPA标准，需确保项目依赖Hibernate实现。

关键注意事项 #

• 版本字段处理：若需严格保留主库版本，需确保归档库对应实体版本与主库一致，或临时关闭乐观锁校验（不推荐）；若无需保留版本，重置为初始值即可。
• 实体完整性：分离实体时必须初始化所有关联对象并完成分离，避免懒加载代理引发的异常。
• 事务一致性：确保所有归档操作在同一个事务内完成，避免部分持久化导致的数据不一致。

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