Java Spring JPA：显式更新托管实体时为何尝试插入未初始化行？

核心结论 #

你对merge()的行为理解确实有误：调用merge()时如果传入的是无ID的游离状态新实体，Hibernate会基于当时实体的状态生成INSERT执行计划，后续对托管实体的字段修改只会触发额外的UPDATE语句，并不会合并成一个完整的INSERT。

错误原因拆解 #

当你执行entityManager.merge(new MyEntity(other))时，这个新实例只有other字段有值，fieldA和fieldB均为null。Hibernate判定这是新实体后，会在后续flush时机（比如事务提交前）执行INSERT操作，但此时的INSERT语句里fieldA和fieldB是null，直接违反了数据库的NOT NULL约束，导致报错。

哪怕你之后调用setFieldA()和setFieldB()赋值，也只会让Hibernate生成针对这两个字段的UPDATE语句，但INSERT已经先触发了约束校验，错误无法避免。

正确实现方式 #

方式一：创建实体时直接填充所有必填字段 #

避免先构造不完整的实体，而是在orElseGet()中直接生成包含所有必填字段的实例：

// 先给MyEntity添加全参构造器
public MyEntity(OtherEntity other, String fieldA, byte[] fieldB) {
    this.other = other;
    this.fieldA = fieldA;
    this.fieldB = fieldB;
}

// 业务方法实现
@Transactional
public void createOrUpdate(OtherEntity other, String fieldA, byte[] fieldB) {
    var myEntity = myEntityRepository.findByOther(other)
        .orElseGet(() -> new MyEntity(other, fieldA, fieldB));
    // 覆盖字段值，兼容更新场景
    myEntity.setFieldA(fieldA);
    myEntity.setFieldB(fieldB);
    // 无需手动调用persist/merge，事务结束时Hibernate会自动处理托管实体的保存/更新
}

如果不想修改构造器，也可以先创建实体再赋值，然后手动托管：

@Transactional
public void createOrUpdate(OtherEntity other, String fieldA, byte[] fieldB) {
    var myEntity = myEntityRepository.findByOther(other)
        .orElseGet(() -> {
            MyEntity newEntity = new MyEntity(other);
            newEntity.setFieldA(fieldA);
            newEntity.setFieldB(fieldB);
            return newEntity;
        });
    myEntity.setFieldA(fieldA);
    myEntity.setFieldB(fieldB);
}

方式二：手动控制flush时机（不推荐） #

若一定要先创建实体再赋值，可通过手动flush确保INSERT语句包含所有字段，但这种方式会增加不必要的操作，仅作参考：

@Transactional
public void createOrUpdate(OtherEntity other, String fieldA, byte[] fieldB) {
    var myEntity = myEntityRepository.findByOther(other)
        .orElseGet(() -> {
            MyEntity newEntity = new MyEntity(other);
            entityManager.persist(newEntity); // 将实体转为托管状态，但暂不flush
            return newEntity;
        });
    myEntity.setFieldA(fieldA);
    myEntity.setFieldB(fieldB);
    entityManager.flush(); // 此时生成包含所有字段的INSERT语句
}

补充说明 #

• merge()的本质：merge()的作用是将游离实体的状态合并到托管实体中。对于无ID的新实体，它会先创建一个托管副本，然后复制原游离实体的状态，这个复制操作在调用merge()时就完成了，后续对托管副本的修改不会回溯到最初的INSERT计划。
• Hibernate flush机制：默认情况下，Hibernate会在事务提交前、执行查询前自动flush，但INSERT语句的内容是基于实体进入托管状态时的快照（或merge时的状态）生成的，后续字段修改只会生成UPDATE。

内容的提问来源于stack exchange，提问作者Paul Maréchal