Hibernate保存已有UUID主键实体时执行Update而非Insert的问题

问题根源 #

Hibernate默认通过主键值是否为Java默认值（比如null）来区分实体状态：

• 若主键为默认值，判定为新建（transient），执行Insert
• 若主键有值，判定为已游离（detached），执行Update

你的Match实体预生成了UUID主键，Hibernate直接将其判定为游离状态，因此调用save()时执行Update而非Insert。

解决方案 #

方案1：指定主键生成策略为ASSIGNED并使用persist() #

显式告知Hibernate主键由应用手动分配，再用persist()方法处理新建实体：

修改实体类的主键注解：

@Entity
@Table(name = "MATCH")
public class Match implements Serializable {
    @Id
    @GeneratedValue(strategy = GenerationType.ASSIGNED) // 添加此注解
    @Column(name = "MATCH_ID")
    private UUID id;

    // 其余字段、构造方法及getter/setter不变
}

修改保存逻辑中的方法调用：

// 替换session.save(currentMatch);
session.persist(currentMatch);

persist()会严格针对新建实体执行Insert，若实体已在数据库中存在则抛出异常，适合确定实体是全新的场景。

方案2：实现Persistable接口自定义新实体判断 #

通过实现Hibernate的Persistable接口，自己控制实体是否为新建状态：

修改实体类：

@Entity
@Table(name = "MATCH")
public class Match implements Serializable, Persistable<UUID> {
    @Id
    @Column(name = "MATCH_ID")
    private UUID id;

    @Transient
    private boolean isNew = true; // 标记是否为新实体

    // 其余字段不变

    @Override
    public UUID getId() {
        return id;
    }

    @Override
    public boolean isNew() {
        return isNew;
    }

    // 提供方法更新状态，保存后可设为false用于后续更新
    public void setIsNew(boolean isNew) {
        this.isNew = isNew;
    }

    // 其余getter/setter不变
}

保存时确保标记为新实体：

currentMatch.setIsNew(true); // 明确标记为新实体
session.save(currentMatch);
// 保存完成后可设置为false，后续操作会执行Update
currentMatch.setIsNew(false);

这种方式灵活性最高，完全由你控制实体的状态判定逻辑。

方案3：使用merge()处理不确定状态的实体 #

如果不确定数据库中是否已有该主键的记录，用merge()方法：Hibernate会先查询数据库，存在则Update，不存在则Insert：

// 替换session.save(currentMatch);
currentMatch = session.merge(currentMatch);

注意：merge()会返回一个被Hibernate会话托管的实体对象，原currentMatch仍然是游离状态，后续操作需使用返回的对象。

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