Hibernate 6.5无法在H2数据库v2+中找到自定义序列的问题求助

我使用自定义序列生成器配置如下：

@GenericGenerator(
        name = "sequence",
        strategy = "de.sist.SequenceGenerator",
        parameters = @org.hibernate.annotations.Parameter(
                name = "sequence_name",
                value = "HIBERNATE_SEQUENCE"
        )
)

对应的HIBERNATE_SEQUENCE已预先存在于嵌入式H2数据库中，但应用启动时Hibernate在org.hibernate.tool.schema.internal.AbstractSchemaValidator#validateSequence处抛出异常，提示序列未知。

我通过自定义H2方言，重写以下方法临时解决了问题：

@Override
public SequenceInformationExtractor getSequenceInformationExtractor() {
    return SequenceInformationExtractorLegacyImpl.INSTANCE;
}

@Override
public String getQuerySequencesString() {
    return "select * from INFORMATION_SCHEMA.SEQUENCES";
}

但这种方式更像是临时 workaround，因为org.hibernate.dialect.H2Dialect#H2Dialect(org.hibernate.dialect.DatabaseVersion)明确将查询字符串设为null，希望找到更合理的解决思路。

1. 确认Hibernate与H2版本兼容性 #

新版本Hibernate（如6.x+）对H2方言的序列查询逻辑做了调整，默认不再依赖getQuerySequencesString，而是通过SequenceInformationExtractor的现代实现获取序列元数据。如果H2版本较旧，可能无法适配Hibernate的新查询逻辑，导致序列无法被识别。建议：

• 升级H2到与当前Hibernate版本匹配的稳定版
• 查阅Hibernate官方文档的版本兼容性矩阵，确保两者版本适配

2. 替换为Hibernate内置序列生成器 #

如果自定义de.sist.SequenceGenerator并非业务必需，建议改用Hibernate原生的@SequenceGenerator配置，它会自动适配H2方言的序列查询逻辑：

@SequenceGenerator(
        name = "sequence",
        sequenceName = "HIBERNATE_SEQUENCE",
        allocationSize = 1 // 根据实际需求调整
)
@GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "sequence")

这种方式无需自定义方言，能避免第三方生成器与Hibernate方言不兼容导致的序列验证问题。

3. 调整Hibernate Schema验证策略 #

若应用允许在启动时自动同步数据库结构（需评估风险），可以调整hibernate.hbm2ddl.auto的取值：

• 将validate改为update：Hibernate会自动创建缺失的序列（如果序列不存在），但不会删除现有结构
• 或设置为none：完全关闭Schema验证，适合生产环境（需确保数据库结构与实体模型一致）

注意：生产环境中使用update需谨慎，避免意外修改数据库结构。

4. 适配自定义序列生成器与Hibernate方言 #

如果必须保留de.sist.SequenceGenerator，可以：

• 检查该生成器的实现逻辑，确认它是否正确向Hibernate暴露了序列名称的元数据
• 自定义SequenceInformationExtractor的实现（而非直接使用LegacyImpl），使其能正确从H2的INFORMATION_SCHEMA中读取序列信息，同时兼容当前H2Dialect的设计

5. 显式指定Hibernate方言版本 #

如果使用的是Hibernate 6.x，H2Dialect会根据数据库版本自动适配。可以在配置中显式指定H2的版本，帮助Hibernate选择正确的序列查询逻辑：

hibernate.dialect=org.hibernate.dialect.H2Dialect
hibernate.dialect.database.version=2.2.220 // 替换为你的H2实际版本

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