Hibernate 6中如何替换已废弃的saveOrUpdate()方法？

首先得明确saveOrUpdate()的核心逻辑：它会自动判断实体状态，瞬时态（无有效ID或ID未对应数据库记录）则执行插入，游离态（有有效ID但当前session中无该实例）则执行更新，持久态则直接同步到数据库。要替代它，需根据实体状态和业务场景选择合适方法，或封装自定义逻辑模拟原行为。

1. 分场景选择merge()或persist() #

确定实体是瞬时态（新创建，无ID或ID未对应数据库记录） #

直接使用persist(entity)，它会插入实体并将其转为持久态，性能优于merge()，因为不会触发额外查询。

确定实体是游离态（已有ID且数据库存在，当前session无该实例） #

使用merge(entity)，但要注意：merge()会返回session中关联的持久化实例，后续需操作这个返回的实例，而非原来的游离态实体。示例：

// 错误写法：操作原游离态实体，修改不会同步到数据库
merge(entity);
entity.setName("newName");

// 正确写法：操作merge返回的持久化实例，修改会在flush时同步
Entity mergedEntity = merge(entity);
mergedEntity.setName("newName");

若session中已存在同ID的持久化实例，merge()会自动将游离态实体的属性复制到该实例上，不会报错，但需避免继续操作原游离态实体，否则会出现状态不一致。

2. 模拟saveOrUpdate()的自动判断逻辑 #

如果需要像原方法一样自动处理两种状态，可封装自定义工具方法，通过判断实体状态选择persist()或merge()：

public <T> void saveOrUpdate(Session session, T entity) {
    // 获取实体ID，此处假设使用JPA的@Id注解，可根据实际配置调整
    Class<T> entityClass = (Class<T>) entity.getClass();
    IdentifierGenerator generator = session.getSessionFactory()
        .getIdentifierGenerator(entityClass.getName());
    Serializable id = session.getIdentifier(entity);
    
    if (id == null || generator.isUnsaved(id)) {
        // 瞬时态，执行persist
        session.persist(entity);
    } else {
        // 游离态，执行merge
        session.merge(entity);
    }
}

其中isUnsaved()方法会根据Hibernate配置判断ID是否为未保存状态（如自增ID的null值、assigned策略的特定值等），能准确识别瞬时态。

3. 避免常见错误的注意事项 #

• 不要在session中同时操作同ID的游离态和持久态实例：比如先通过load()获取一个实体，再对同ID的游离态实体调用merge()，此时需操作merge()返回的实例，而非原游离态实体。
• persist()不可用于已有数据库记录的实体：它仅执行插入操作，直接使用会导致主键冲突，这正是你遇到该报错的原因。
• 若使用Spring Data JPA，可直接用save()方法：其内部已实现类似saveOrUpdate()的逻辑，会自动判断执行persist()或merge()，无需自行处理。

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