Spring JPA已手动设置主键时如何避免自动生成新主键值？

问题根因 #

你实体的主键字段添加了@GeneratedValue注解，只要配置了该注解，Hibernate（Spring JPA默认ORM实现）就会默认忽略你手动为id赋值的值，在执行save操作时自动调用指定序列生成新的主键值。你手动查询了一次nextval拿到值赋给了id和field1，Hibernate执行插入时又调用了一次序列生成新的id，最终存储的id自然就比field1大1。

解决方案 #

方案一：使用@PrePersist回调自动同步（最简便，适合仅需field1和id一致的场景） #

不需要手动提前查询序列，利用JPA实体生命周期回调，在Hibernate生成id后、实体插入数据库前，自动将id赋值给field1，完全避免手动调用序列的逻辑。
实体代码修改如下：

public class MyEntity implements Serializable {

    @Id
    @Column(name = "id")
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "SEQ_MY_ENTITY")
    @SequenceGenerator(sequenceName = "SEQ_MY_ENTITY", allocationSize = 1, name = "SEQ_MY_ENTITY")
    private Long id;

    @Column(name = "field1")
    private String field1;

    // 新增生命周期回调方法
    @PrePersist
    public void prePersist() {
        // 可根据业务判断是否需要覆盖已有的field1值
        if (this.field1 == null) {
            this.field1 = String.valueOf(this.id);
        }
    }
}

业务代码直接正常创建实体、设置其他字段、调用save即可，无需手动处理id和field1，两者存储值自然一致。

方案二：自定义主键生成器，支持手动赋值优先（适合部分场景需要手动指定id的场景） #

自定义序列生成器，逻辑为：如果实体已经手动设置了id值就直接用该值，没有设置时再自动调用序列生成。

1. 首先实现自定义生成器类：

import org.hibernate.HibernateException;
import org.hibernate.engine.spi.SharedSessionContractImplementor;
import org.hibernate.id.enhanced.SequenceStyleGenerator;
import java.io.Serializable;

public class ManualAssignSupportSequenceGenerator extends SequenceStyleGenerator {
    @Override
    public Serializable generate(SharedSessionContractImplementor session, Object object) throws HibernateException {
        // 读取实体当前已经赋值的id
        Serializable id = session.getEntityPersister(null, object)
                .getClassMetadata()
                .getIdentifier(object, session);
        // id不为空则直接使用手动赋值的内容，否则走原序列生成逻辑
        if (id != null) {
            return id;
        }
        return super.generate(session, object);
    }
}

2. 修改实体主键的生成策略配置，替换为自定义生成器：

@Id
@Column(name = "id")
@GenericGenerator(
    name = "custom_myentity_seq",
    strategy = "你的包路径.ManualAssignSupportSequenceGenerator",
    parameters = {
        @Parameter(name = "sequence_name", value = "SEQ_MY_ENTITY"),
        @Parameter(name = "allocation_size", value = "1")
    }
)
@GeneratedValue(generator = "custom_myentity_seq")
private Long id;

修改完成后，你原有手动查询序列、赋值给id和field1的业务逻辑可以直接复用，不会再出现自动生成新id的问题。

方案三：移除自动生成注解，完全手动控制id（适合所有场景都需手动指定id的场景） #

如果你的业务所有场景下都需要自己控制id的生成逻辑，不需要JPA自动生成，直接删除主键上的@GeneratedValue和@SequenceGenerator注解即可，JPA会直接使用你手动赋值的id作为主键存储，不会再自动调用序列。

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