如何通过Hibernate EntityManager更新含ID的游离实体？

现状与问题 #

使用Quarkus和Hibernate开发REST API，需实现PUT端点接收完整实体以更新数据库中已有数据。当前端点与仓库实现如下：

资源端点代码 #

@PUT
@Path("/")
@Consumes(MediaType.APPLICATION_JSON)
@Produces(MediaType.APPLICATION_JSON)
public Settings update(@Valid Settings settings) {
    return settingRepository.update(settings);
}

仓库类测试方法 #

@Transactional
public Settings update(Settings settings) {
    // 尝试用Hibernate Session更新，触发主键重复错误
    entityManager.unwrap(Session.class).update(settings);
    return settings;
}

核心问题：传入的实体处于游离状态，EntityManager的merge()、persist()无法直接满足需求；使用Hibernate Session的update()、saveOrUpdate()时触发PostgreSQL主键唯一约束错误：

Caused by: org.postgresql.util.PSQLException: ERROR: duplicate key value violates unique constraint "settings_pkey"
  Detail: Key (id)=(1) already exists.

不想通过“查库-修改-保存”的方式产生不必要的数据库往返，也不愿手动编写全字段JPQL查询。

可行解决方案 #

1. 正确使用JPA标准的merge()方法 #

merge()是JPA专为处理游离实体设计的方法，逻辑为：根据传入实体的主键查询数据库，若找到对应托管实体，则将游离实体的属性复制到托管实体中并自动执行更新；若未找到，则插入新实体（可通过业务逻辑限制仅更新）。

修正后的仓库方法：

@Transactional
public Settings update(Settings settings) {
    // 若需严格仅更新现有实体，添加存在性检查
    if (entityManager.find(Settings.class, settings.getId()) == null) {
        throw new IllegalArgumentException("Settings ID " + settings.getId() + " 不存在");
    }
    return entityManager.merge(settings);
}

注：若允许PUT语义下的“upsert”（不存在则插入），可直接去掉存在性检查，merge()会自动处理更新/插入逻辑。

2. 修复Hibernate Sessionupdate()/saveOrUpdate()的使用问题 #

之前触发主键错误，大概率是当前Session中已存在同主键的托管实体，或实体主键生成策略配置冲突（如使用IDENTITY生成策略但手动传入主键）。

方案A：清除Session中冲突的托管实例

@Transactional
public Settings update(Settings settings) {
    Session session = entityManager.unwrap(Session.class);
    // 移除Session中可能存在的同主键托管实体
    Settings existing = session.find(Settings.class, settings.getId());
    if (existing != null) {
        session.evict(existing);
    }
    session.update(settings);
    return settings;
}

方案B：使用saveOrUpdate()替代update()

saveOrUpdate()会根据主键是否存在自动判断执行插入或更新，适合不确定实体是否存在的场景：

@Transactional
public Settings update(Settings settings) {
    Session session = entityManager.unwrap(Session.class);
    session.saveOrUpdate(settings);
    return settings;
}

若主键生成策略为IDENTITY，需确保实体类中@Id字段未设置自动生成，或改用AUTO/手动指定主键的策略。

3. 无查询的JPQL批量更新（性能敏感场景） #

若完全不想触发数据库查询，可编写JPQL直接执行更新，缺点是不会触发实体生命周期回调（如@PreUpdate），且Session缓存不会自动更新：

@Transactional
public int updateSettings(Settings settings) {
    return entityManager.createQuery(
            "UPDATE Settings s SET s.name = :name, s.value = :value WHERE s.id = :id"
        )
        .setParameter("name", settings.getName())
        .setParameter("value", settings.getValue())
        .setParameter("id", settings.getId())
        .executeUpdate();
}

推荐方案 #

优先选择方法1的merge()实现，既符合JPA规范，又能优雅处理游离实体的更新逻辑，同时可通过简单的存在性检查严格符合PUT端点的语义（仅更新现有资源）。

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