Spring Boot3升级Hibernate6时出现Schema-validation: missing table错误求助

背景 #

已将Spring Boot项目从2.5.12版本升级至3.0.0，同步将Hibernate升级到6.1.5版本，所有Java实体类已按要求替换为jakarta.persistence包替代原javax.persistence包。

问题现象 #

应用启动时抛出错误：

Schema-validation: missing table ...

错误源自org.hibernate.tool.schema.internal.AbstractSchemaValidator类的validateTable方法，相关核心代码如下：

@Override
protected void validateTables(
        Metadata metadata,
        DatabaseInformation databaseInformation,
        ExecutionOptions options,
        ContributableMatcher contributableInclusionFilter,
        Dialect dialect, Namespace namespace) {

    final NameSpaceTablesInformation tables = databaseInformation.getTablesInformation( namespace );
    for ( Table table : namespace.getTables() ) {
        if ( options.getSchemaFilter().includeTable( table )
                && table.isPhysicalTable()
                && contributableInclusionFilter.matches( table ) ) {
            validateTable(
                    table,
                    tables.getTableInformation( table ),
                    metadata,
                    options,
                    dialect
            );
        }
    }
}

补充信息 #

• 数据库表实际存在，可登录数据库查看；
• databaseInformation.getTablesInformation( namespace )返回空结果；
• namespace.getTables()能正确显示所有表；
• 构建时Hibernate生成类正常，注解生效；
• 使用MySQLDialect；
• 实体类仅替换了persistence包，无其他变更；
• 未出现连接拒绝错误，数据库连接正常。

可能原因分析 #

结合补充信息，问题核心是Hibernate无法从数据库读取对应Schema的表信息，具体可能原因如下：

1. Schema名称配置不匹配 #

Hibernate 6.x对Schema的处理逻辑有变化，若使用非默认数据库Schema，需检查：

• 配置项spring.jpa.properties.hibernate.default_schema是否正确设置，注意大小写敏感（MySQL在Linux环境下Schema名称区分大小写）；
• 实体类@Table注解的schema属性是否和数据库实际Schema一致，升级后是否因包替换误改注解属性。

2. MySQLDialect兼容性问题 #

MySQLDialect在Hibernate 6.x中已标记为过时，建议替换为对应MySQL版本的专用Dialect：

• MySQL 8.x使用org.hibernate.dialect.MySQL8Dialect；
• MySQL 5.7使用org.hibernate.dialect.MySQL57Dialect。
  过时的MySQLDialect可能在读取数据库元数据时出现逻辑错误，导致无法获取表信息。

3. 数据库用户权限不足 #

虽然数据库连接正常，但连接用户可能缺少读取数据库元数据的权限（如SHOW TABLES、SELECT INFORMATION_SCHEMA.TABLES等），导致Hibernate无法查询到表信息。可执行以下SQL验证权限：

SHOW GRANTS FOR 'your_user'@'your_host';

若缺少权限，需为用户添加对应权限。

4. Hibernate配置项变更 #

Spring Boot 3.0对应的Hibernate 6.x修改了部分配置项的名称或默认值，检查以下配置：

• spring.jpa.hibernate.ddl-auto是否设置为validate；
• 是否新增spring.jpa.properties.hibernate.schema_filter_provider等过滤配置，导致Hibernate过滤掉需验证的表；
• 检查spring.jpa.properties.hibernate.temp.use_jdbc_metadata_defaults是否被设为false，该配置关闭会导致Hibernate不读取数据库元数据。

5. 实体类表名大小写问题 #

MySQL在不同操作系统下表名大小写规则不同（Windows不区分，Linux区分），若实体类@Table注解的name属性大小写与数据库实际表名不一致，Hibernate 6.x的验证逻辑更严格，会导致无法匹配。比如实体类写@Table(name = "user")，但数据库实际表名是USER，在Linux环境下就会触发该错误。

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