Hibernate 6.5.2升级后，枚举Ordinal映射跨Oracle、SQL Server兼容问题

针对你遇到的Hibernate升级后枚举ordinal类型映射与现有数据库架构不兼容的问题，以下是几种实用的解决方案：

方案1：多环境动态配置columnDefinition（推荐） #

利用Spring Profile或Hibernate属性占位符，为不同数据库设置对应的列定义，避免硬编码：

1. 配置多环境属性文件

   • 在application-oracle.properties中添加：

     hibernate.enum.column.type=NUMBER(10,0)
     

   • 在application-sqlserver.properties中添加：

     hibernate.enum.column.type=int
     

2. 修改实体类枚举字段
   在所有标注@Enumerated(EnumType.ORDINAL)的枚举字段上，使用占位符指定列定义：

   @Enumerated(EnumType.ORDINAL)
   @Column(columnDefinition = "${hibernate.enum.column.type}")
   private YourEnum yourEnumField;
   

3. 启动时激活对应环境
   根据部署环境激活对应的Spring Profile，比如启动时添加参数--spring.profiles.active=oracle或sqlserver，Hibernate会自动加载对应环境的列定义，schema验证即可通过。

方案2：自定义数据库方言 #

通过重写Hibernate方言，为不同数据库覆盖枚举ordinal的默认类型映射：

自定义SQL Server方言 #

创建自定义方言类，将枚举ordinal对应的JDBC类型映射为SQL Server的INT：

public class CustomSQLServerDialect extends SQLServerDialect {
    public CustomSQLServerDialect() {
        super();
        // 将SMALLINT/TINYINT类型映射为SQL Server的INT，匹配现有库字段类型
        registerColumnType(Types.SMALLINT, "int");
        registerColumnType(Types.TINYINT, "int");
    }
}

配置方言 #

在对应环境的配置文件中指定自定义方言：

• SQL Server环境：

  spring.jpa.properties.hibernate.dialect=com.yourpackage.CustomSQLServerDialect
  

• Oracle环境保持默认方言即可：

  spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.OracleDialect
  

这种方式无需修改实体类，适合大量枚举字段的场景。

方案3：自定义JdbcType统一处理 #

编写自定义JdbcType，根据当前数据库方言动态返回对应的JDBC类型：

public class CrossDbEnumOrdinalJdbcType extends EnumOrdinalJdbcType {

    @Override
    public int getJdbcTypeCode() {
        // 获取当前数据库方言
        Dialect dialect = getCurrentSessionFactory().getJdbcServices().getDialect();
        
        if (dialect instanceof OracleDialect) {
            return Types.NUMERIC; // 匹配Oracle的NUMBER(10,0)
        } else if (dialect instanceof SQLServerDialect) {
            return Types.INTEGER; // 匹配SQL Server的INT
        }
        return super.getJdbcTypeCode();
    }

    private SessionFactory getCurrentSessionFactory() {
        // 从上下文获取SessionFactory，示例方式根据你的项目调整
        EntityManager em = Persistence.createEntityManagerFactory("yourPU").createEntityManager();
        return em.unwrap(Session.class).getSessionFactory();
    }
}

然后在实体类枚举字段上指定该自定义类型：

@Enumerated(EnumType.ORDINAL)
@JdbcType(CrossDbEnumOrdinalJdbcType.class)
private YourEnum yourEnumField;

此方案适合需要统一处理所有枚举字段的场景，但需要注意SessionFactory的获取逻辑适配你的项目架构。

兜底方案：关闭Schema验证（不推荐） #

如果以上方案都无法快速落地，可以临时关闭Hibernate的schema验证，但会失去架构一致性检查的能力：

spring.jpa.hibernate.ddl-auto=none

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