Hibernate生成ID异常：data.sql初始化后主键冲突

核心原因 #

data.sql手动插入了指定ID的测试数据，但Hibernate的主键生成器（比如IDENTITY）依赖数据库自增计数器，手动插入ID不会更新这个计数器，导致新增数据时计数器仍从1开始，触发主键冲突。

可行解决方案 #

方案1：更新数据库自增计数器（适用于IDENTITY策略） #

在data.sql末尾添加SQL语句，强制将表的自增计数器重置为现有最大ID+1：

-- 替换your_table和id为实际表名和主键列名
ALTER TABLE your_table ALTER COLUMN id RESTART WITH (SELECT MAX(id) + 1 FROM your_table);

这样Hibernate新增数据时，数据库会从正确的起始值生成ID。

方案2：改用SEQUENCE主键生成策略（推荐） #

1. 修改Entity类的主键注解，使用SEQUENCE：

@Entity
@Table(name = "your_table")
public class YourEntity {
    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "your_entity_seq")
    @SequenceGenerator(
        name = "your_entity_seq",
        sequenceName = "YOUR_ENTITY_SEQ",
        allocationSize = 1
    )
    private Long id;

    // 其他字段和方法
}

2. 在data.sql末尾初始化序列值，确保从现有数据的最大ID+1开始：

-- 替换序列名和表名
ALTER SEQUENCE YOUR_ENTITY_SEQ RESTART WITH (SELECT MAX(id) + 1 FROM your_table);

SEQUENCE策略比IDENTITY更灵活，尤其在多数据源或复杂场景下更可靠。

方案3：插入测试数据时不指定ID（如果允许） #

如果测试数据不需要固定ID，删除data.sql中插入语句的ID字段，让数据库自动生成ID：

-- 原语句（指定ID）
INSERT INTO your_table (id, name) VALUES (1, 'test1'), (2, 'test2');

-- 修改后（自动生成ID）
INSERT INTO your_table (name) VALUES ('test1'), ('test2');

这样自增计数器会随着插入自动更新，后续新增数据不会冲突。

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