Spring Boot REST Repository无法在H2数据库创建记录：序列不存在

问题背景 #

你通过Postman调用POST接口 http://localhost:8080/client 创建资源时失败，报错提示org.h2.jdbc.JdbcSQLException: Sequence "HIBERNATE_SEQUENCE" not found，但GET、PUT、DELETE方法都能正常工作，使用的是Spring Data REST自动生成的端点，请求Payload如下：

{ "clientName": "Walmart", "active": "Y" }

问题核心原因 #

这个错误的本质是：Hibernate默认会使用全局序列HIBERNATE_SEQUENCE来生成实体主键，但你的H2数据库里并没有预先创建这个序列。而GET/PUT/DELETE操作不需要生成新的主键，所以不受影响，只有POST创建新资源时会触发主键生成逻辑，才会抛出这个异常。

可行解决方案 #

下面提供几种针对性的解决方式，你可以根据项目实际情况选择：

1. 手动在H2数据库中创建全局序列

如果想保留Hibernate的全局序列策略，直接在H2控制台执行SQL创建序列即可：

CREATE SEQUENCE HIBERNATE_SEQUENCE START WITH 1 INCREMENT BY 1;

执行完成后重启应用，POST接口就能正常创建资源了。

2. 配置Hibernate自动维护数据库结构（适合开发环境）

在application.properties或application.yml中添加配置，让Hibernate自动生成所需的序列和表结构：

# application.properties
spring.jpa.hibernate.ddl-auto=update

或者YAML格式：

# application.yml
spring:
  jpa:
    hibernate:
      ddl-auto: update

这个配置会让Hibernate根据你的实体类映射，自动创建或更新数据库结构（包括所需的序列）。注意：生产环境不建议使用update，推荐搭配Flyway/Liquibase这类数据库迁移工具来管理结构变更。

3. 为实体类指定独立的主键生成策略

如果不想依赖全局序列，可以在Client实体的主键字段上指定专属的生成策略：

• 使用自增主键（H2原生支持）：

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;

@Entity
public class Client {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    private String clientName;
    private String active;
    
    // 构造函数、getter、setter省略
}

GenerationType.IDENTITY会让H2数据库自动生成自增主键，完全不需要额外创建序列。

• 指定自定义专属序列：
  如果还是想用序列生成主键，可以为实体指定专属序列：

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import javax.persistence.SequenceGenerator;

@Entity
public class Client {
    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "client_seq")
    @SequenceGenerator(name = "client_seq", sequenceName = "CLIENT_SEQUENCE", allocationSize = 1)
    private Long id;
    
    // 其他字段、方法省略
}

这样Hibernate会使用CLIENT_SEQUENCE而非全局的HIBERNATE_SEQUENCE，配合ddl-auto=update配置的话，Hibernate会自动创建这个专属序列。

4. 检查实体类主键注解配置

确认你的Client实体主键字段上的@GeneratedValue注解配置正确，如果没有显式指定strategy，Hibernate会根据数据库方言选择默认策略——在H2中默认会使用序列，这就要求全局的HIBERNATE_SEQUENCE必须存在。

验证方式 #

修改完成后重启应用，再次用Postman发送POST请求，应该就能成功创建Client资源了。如果还有问题，可以打开H2控制台查看数据库结构，确认序列或自增主键是否已经正确生成。

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