使用H2数据库持久化到文件系统时无法自动创建表的问题

问题场景 #

搭建基础Spring CRUD应用时，使用H2文件系统持久化存储（而非内存存储），应用启动后无法自动创建实体对应的数据库表；触发实体保存操作时，抛出序列不存在的错误。但切换为H2内存存储时，无需额外配置就能自动建表，添加spring.jpa.hibernate.ddl-auto=update配置后，文件系统模式也能正常自动建表，对此存在疑问。

相关代码与配置 #

实体类代码 #

@Entity
@Getter
@Setter
@NoArgsConstructor
public class PropertyEntity {

    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    private Long id;
    private String title;
    private String description;
    private String ownerName;
    private String price;
    private String address;
    private String ownerEmail;

}

application.properties配置 #

spring.datasource.url=jdbc:h2:file:D:/coderunner/pmsdb
spring.datasource.driverClassName=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=
spring.jpa.database-platform=org.hibernate.dialect.H2Dialect
spring.h2.console.enabled=true
spring.jpa.show-sql=true

触发的错误信息 #

org.h2.jdbc.JdbcSQLSyntaxErrorException: Sequence "HIBERNATE_SEQUENCE" not found; SQL statement:
call next value for hibernate_sequence [90036-214]
    at org.h2.message.DbException.getJdbcSQLException(DbException.java:632) ~[h2-2.1.214.jar:2.1.214]
    at org.h2.message.DbException.getJdbcSQLException(DbException.java:477) ~[h2-2.1.214.jar:2.1.214]

原因分析 #

• Spring Boot对H2内存数据库有特殊默认配置：当检测到数据源URL包含mem:（内存模式标识）时，会自动将spring.jpa.hibernate.ddl-auto设为create-drop，所以启动时会自动创建表和对应的序列。
• 而H2文件系统模式属于持久化数据库，Spring Boot不会自动设置ddl-auto属性，Hibernate 5+版本中该属性默认值为none，意味着Hibernate不会执行任何自动DDL操作，因此表和序列都不会被创建，最终导致保存实体时抛出序列不存在的错误。

解决方案 #

明确配置spring.jpa.hibernate.ddl-auto属性，根据场景选择对应值：

• update：启动时检查实体与表结构差异，更新表结构且保留已有数据，适合开发环境迭代使用
• create：每次启动都重新创建表，原有数据会被清空，适合临时测试
• create-drop：启动时创建表，应用关闭时自动删除表，适合测试环境
• validate：仅验证实体与现有表结构是否匹配，不修改表结构，适合生产环境（生产环境更推荐用Flyway、Liquibase等数据库迁移工具管理表结构）

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