Spring Boot+Hibernate+H2中@GeneratedValue与data.sql数据冲突求助

问题背景 #

基于Spring Boot 2.7.5开发员工管理API，Employee实体类的id字段使用@Id @GeneratedValue(strategy = GenerationType.IDENTITY)注解。未添加data.sql时接口正常，但插入5条id为1-5的初始化数据后，调用POST新增员工触发SQL Error:23505主键唯一约束冲突——JPA会反复尝试已被占用的ID，直到找到可用值才恢复。

核心原因 #

使用GenerationType.IDENTITY时，主键生成依赖数据库的自增列机制。H2数据库执行data.sql手动插入数据后，自增列的序列起始值并未自动更新为已插入数据的最大ID+1，导致JPA调用自增时仍从1开始生成ID，与已有数据冲突。

可行解决方案 #

方案1：手动同步H2自增序列起始值 #

在data.sql的末尾添加SQL语句，强制将自增列的起始值设置为已插入数据的最大ID+1（这里是6）：

-- 针对employee表的id自增列，从6开始自增
ALTER TABLE employee ALTER COLUMN id RESTART WITH 6;

执行后，数据库自增序列会跳过已占用的1-5，后续新增数据的ID会从6开始生成。

方案2：改用SEQUENCE策略并初始化序列 #

1. 修改Employee实体类的主键注解，指定序列生成器：

@Id
@GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "employee_seq")
@SequenceGenerator(
    name = "employee_seq",
    sequenceName = "employee_sequence",
    initialValue = 6,  -- 跳过已占用的1-5
    allocationSize = 1
)
private Long id;

2. 在data.sql中创建并初始化序列（如果schema.sql未提前创建）：

CREATE SEQUENCE IF NOT EXISTS employee_sequence START WITH 6;

这种方式让JPA明确使用指定序列生成ID，避免依赖数据库自增列的同步问题。

方案3：配置AUTO策略适配序列 #

如果偏好使用GenerationType.AUTO，可在application.properties中添加以下配置：

spring.jpa.hibernate.ddl-auto=update
spring.jpa.properties.hibernate.id.new_generator_mappings=true

同时在data.sql末尾添加序列调整语句（针对H2自动生成的序列）：

-- H2中AUTO策略默认生成的序列名为hibernate_sequence
ALTER SEQUENCE hibernate_sequence RESTART WITH 6;

注意事项 #

• 避免混用IDENTITY策略和手动插入ID，这是导致序列不同步的根本原因；
• 若使用schema.sql创建表，需确保自增列定义为id BIGINT AUTO_INCREMENT PRIMARY KEY（H2语法）。

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