如何使用JpaRepository实现仅当实体ID为空时自动生成ID

该异常的触发有两个核心逻辑点：

1. Spring Data JPA save() 方法默认的新实体判定规则：若主键字段不为空，则判定该实体为已持久化过的游离态实体，会尝试调用merge操作；若判定为新实体才会调用persist操作。
2. Hibernate 自定义IdentifierGenerator的触发规则：仅当实体主键为空时，才会调用自定义生成器生成主键；若主键已赋值，则跳过生成器逻辑，直接执行后续持久化校验，判定手动赋值ID的新实体为游离态，抛出detached entity passed to persist异常。

不需要额外自定义主键生成器，也不需要手动调用merge，仅通过调整实体配置即可实现需求，以下是两种可行方案：

方案1：实现Persistable接口自定义新实体判定逻辑 #

通过新增瞬态字段标记实体是否为新，从根本上修改Spring Data JPA的实体判定规则，配合@PrePersist回调实现ID为空时自动生成：

@Entity
@Table(name = "JOURNAL")
@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class JournalEntity extends AbstractEntity<UUID> implements Persistable<UUID> {

    @Id
    @Column(name = "id", updatable = false, nullable = false)
    UUID id;
    String name;

    // 瞬态字段不参与持久化，默认标记为新实体
    @Transient
    @Builder.Default
    private boolean isNew = true;

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

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

    // 实体持久化完成后修改标记位，后续更新操作不会被判定为新实体
    @PostPersist
    void markAsNotNew() {
        this.isNew = false;
    }

    // 持久化前自动补全空ID
    @PrePersist
    void generateIdIfNull() {
        if (this.id == null) {
            this.id = UUID.randomUUID();
        }
    }
}

Repository不需要做任何修改，直接调用save()方法即可，手动赋值ID的新实体也会正常走persist逻辑插入。

方案2：新增乐观锁@Version字段（推荐） #

如果业务允许增加乐观锁，可使用更简洁的方案：Spring Data JPA对带有@Version字段的实体，新判定规则为「ID为空 或 Version字段为空」，因此只要新增的实体Version字段为null，就算手动赋值了ID也会被判定为新实体：

@Entity
@Table(name = "JOURNAL")
@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class JournalEntity extends AbstractEntity<UUID> {

    @Id
    @Column(name = "id", updatable = false, nullable = false)
    UUID id;
    String name;

    // 乐观锁字段，新增实体默认值为null，持久化时自动赋值为0
    @Version
    private Integer version;

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

    // 持久化前自动补全空ID
    @PrePersist
    void generateIdIfNull() {
        if (this.id == null) {
            this.id = UUID.randomUUID();
        }
    }
}

该方案不仅可以解决当前问题，还能顺便解决并发更新的冲突问题，无需额外维护新实体标记位。

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