使用String作为User主键时H2测试库报HIBERNATE_SEQUENCE不存在错误

核心问题 #

你遇到的问题是Hibernate在H2数据库环境下，默认尝试使用序列生成主键，但你的User表主键是手动传入的String类型username，且未配置对应序列，导致报错。生产环境PostgreSQL正常是因为其方言对手动赋值主键的处理逻辑与H2不同。

解决方案 #

方案1：显式指定主键生成策略

在User类的主键字段上添加@GeneratedValue(strategy = GenerationType.ASSIGNED)，明确告知Hibernate主键由外部手动赋值，无需自动生成：

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.ASSIGNED)
    private String username;

    // 其他字段、构造方法及Getter/Setter
}

方案2：修改Hibernate配置（适用于不想修改实体类的场景）

在测试环境的配置文件（如application-test.properties或application-test.yml）中添加以下配置，禁用Hibernate的新生成器映射，使其尊重手动赋值的主键：

# application-test.properties
spring.jpa.hibernate.id.new_generator_mappings=false

为什么会出现这个问题 #

尽管你没有添加@GeneratedValue注解，但Hibernate的默认主键生成策略会因数据库方言差异而变化。PostgreSQL方言在处理非自增的手动赋值主键时，不会主动触发序列查询；而H2的默认方言会默认尝试使用序列生成策略，导致去查找不存在的HIBERNATE_SEQUENCE。

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