Spring Boot 2.5对接遗留库时JPA/Hibernate如何适配DB生成的主键

问题解决配置方案 #

你这个场景属于数据库端生成主键、应用层插入时不提供主键值、插入完成后从数据库回读主键的典型场景，有两种稳定可行的配置方式：

方案1：Hibernate专用注解方案（适配性最好）

依赖Hibernate原生注解适配计算型持久化主键，无需额外逻辑改造：

import org.hibernate.annotations.Generated;
import org.hibernate.annotations.GenerationTime;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import jakarta.persistence.Table;

@Entity
@Table(name="items")
public static class ItemEntity {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Generated(GenerationTime.INSERT)
    @Column(insertable = false, updatable = false)
    private String id;

    // 其他字段、getter/setter省略
}

各注解作用说明：

• @Column(insertable = false, updatable = false) 明确告诉JPA生成SQL时，插入、更新操作都不携带id字段，完全交给数据库生成
• @Generated(GenerationTime.INSERT) 告知Hibernate该字段在插入操作时由数据库生成，插入完成后需要回读同步到实体对象
• GenerationType.IDENTITY 适配底层serial字段为自增identity的生成逻辑，符合你的表结构设计

方案2：纯JPA兼容方案（无Hibernate私有依赖）

如果需要避免依赖Hibernate私有注解，可以用select生成器策略，插入完成后通过唯一键回查主键：

import jakarta.persistence.GeneratedValue;
import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import jakarta.persistence.Table;
import org.hibernate.annotations.GenericGenerator;

@Entity
@Table(name="items")
public static class ItemEntity {

    @Id
    @GeneratedValue(generator = "db-generated-id")
    @GenericGenerator(name = "db-generated-id", strategy = "select")
    @Column(insertable = false, updatable = false)
    private String id;

    // 需额外映射自增serial字段作为回查唯一键
    @Column(name = "serial", insertable = false, updatable = false)
    private Integer serial;

    // 其他字段、getter/setter省略
}

该方案的前提是实体类中保留可唯一标识刚插入记录的字段（如本例的serial自增字段），Hibernate会在插入完成后用该字段查询得到数据库生成的id值。

版本适配说明 #

Spring Boot 2.5默认自带的Hibernate 5.6.x版本原生支持上述两种配置，无需额外引入依赖。

内容的提问来源于stack exchange，提问作者A'B