Hibernate update遇NonUniqueObjectException，merge却删除数据

首先得说，你遇到的这两个问题其实都和Hibernate的持久化上下文（Session）缓存机制脱不了干系，咱们一个个来捋清楚：

一、为什么update()会触发NonUniqueObjectException？ #

这个异常的核心原因很直白：当前Session里已经存在一个和你要update的对象拥有相同ID的持久化实例了。

举个场景：你加载了X类型的数组，假设数组里某两个元素的ID是重复的；或者你在加载数组之后，又通过session.get(X.class, id)/session.load(X.class, id)获取了同一个ID的对象，这时候Session的一级缓存里就有两个同ID的对象了——Hibernate绝对不允许这种情况，因为它要保证Session中每个数据库ID对应唯一的持久化对象，避免状态混乱。

哪怕你没修改第二个X实例，只要Session里已经存在同ID的对象，调用update()时Hibernate就会抛出这个异常。

二、merge()为什么会删除数据？ #

merge()的逻辑其实很容易被误解：它不是直接更新你传入的对象，而是把你传入的游离对象的属性，复制到Session中已存在的同ID持久化对象上；如果Session里没有，就创建一个新的持久化对象，最后返回这个持久化对象。

你遇到的“删除数组中除两个元素外的所有数据”，大概率是这几种情况：

1. 错误忽略了merge()的返回值：merge()返回的才是Session管理的持久化对象，你原来传入的游离对象还是游离状态。如果你后续继续用原来数组里的对象操作，等于没把修改同步到Session里，最后提交时自然丢失数据。
2. 数组里存在重复ID的对象：如果数组里多个对象ID相同，后面merge的对象会把属性覆盖到Session里的同一个持久化对象上，前面的修改都被冲掉，看起来就像“丢失了数据”。
3. 映射/级联配置错误：比如你的X类关联了其他实体，设置了cascade="merge"但级联关系配置不对，导致merge时意外触发了关联对象的删除操作；或者实体类的ID生成策略有问题，merge时生成了重复ID覆盖了原有数据。

三、解决方案 #

针对update()的异常 #

你可以换两种思路处理：

• 直接修改Session中的持久化对象：先从Session中获取对应ID的持久化实例，直接修改它的属性，Hibernate会通过脏检查自动在提交时更新数据库，根本不需要调用update()。示例代码：

X[] xArray = loadXArray();
for (X x : xArray) {
    // 先从Session中拿持久化实例
    X persistentX = session.get(X.class, x.getId());
    if (persistentX != null) {
        // 把游离对象x的属性复制到持久化对象上
        persistentX.setName(x.getName());
        persistentX.setXXX(x.getXXX());
        // 不用调用update，Hibernate自动处理
    } else {
        // 如果Session里没有，说明是新对象，直接save
        session.save(x);
    }
}

• 先清理Session中的重复实例：如果必须用update()，先检查Session里有没有同ID的对象，用session.contains(x)判断，有的话先调用session.evict(persistentX)把它从Session缓存中移除，再调用update(x)。

针对merge()的数据丢失 #

• 正确使用merge()的返回值：每次merge后，把返回的持久化对象存起来，后续操作都用这个对象，而不是原来的游离对象。示例：

X[] xArray = loadXArray();
List<X> validXList = new ArrayList<>();
for (X x : xArray) {
    // merge后拿到Session管理的持久化对象
    X mergedX = (X) session.merge(x);
    validXList.add(mergedX);
}
// 后续操作都用validXList里的对象，不要碰原来的xArray

• 检查数组中的对象ID：确保数组里的每个X实例ID都是唯一的，避免重复ID导致的属性覆盖。
• 核对实体映射配置：检查X类的@Entity注解、ID生成策略、关联关系的级联设置，确保没有错误的cascade配置导致意外删除。

最后提醒 #

Hibernate的Session是一级缓存，它的核心原则是同一个Session中，每个数据库ID对应唯一的持久化对象——所有的update/merge操作都要遵循这个原则，不然很容易踩坑。

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