Hibernate从5.x升级到6.x后SQL Server插入报错求助

问题根源 #

Hibernate 6.x对GenerationType.AUTO结合@SequenceGenerator的处理逻辑发生了变化：5.x版本中，针对SQL Server会自动适配IDENTITY列的自增策略，忽略序列生成器配置；但6.x版本会严格遵循指定的序列生成器生成ID，导致尝试向IDENTITY列插入显式值，触发SQL Server的IDENTITY_INSERT is set to OFF报错。

解决方法 #

针对MySQL、SQL Server、Oracle多数据库兼容场景，推荐以下方案：

方案1：依赖Hibernate方言自动适配ID生成策略 #

移除@SequenceGenerator注解，仅保留@GeneratedValue(strategy = GenerationType.AUTO)，让Hibernate根据不同数据库方言自动选择合适的ID生成方式：

• SQL Server：使用IDENTITY自增列
• MySQL：使用自增主键
• Oracle：自动创建或使用默认序列

修改后的实体ID代码：

@Id
@GeneratedValue(strategy = GenerationType.AUTO)
private int id;

若Oracle需要指定自定义序列名，可通过Hibernate配置文件（hibernate.cfg.xml或application.properties）为Oracle方言单独配置序列规则，避免硬编码注解。

方案2：用条件注解针对不同数据库配置ID策略 #

利用Hibernate的@DialectOverride注解，为不同数据库指定对应的ID生成策略，兼顾代码统一性与数据库特异性：

@Id
// SQL Server环境使用IDENTITY自增策略
@GeneratedValue(strategy = GenerationType.IDENTITY)
// Oracle环境使用指定序列生成器
@DialectOverride.GeneratedValue(
        dialect = OracleDialect.class,
        generator = "EmailMessageTemplate_SeqGenerator"
)
@SequenceGenerator(
        name = "EmailMessageTemplate_SeqGenerator",
        sequenceName = "EmailMessageTemplate_Seq"
)
private int id;

方案3：临时开启IDENTITY_INSERT（仅调试用，不推荐生产） #

若仅用于临时调试，可在插入操作前后执行SQL切换IDENTITY_INSERT状态：

SET IDENTITY_INSERT EmailMessageTemplate ON;
-- 执行插入操作
SET IDENTITY_INSERT EmailMessageTemplate OFF;

此方法会破坏SQL Server的IDENTITY列约束，且需手动管理事务，不适合生产环境。

验证步骤 #

1. 在SQL Server环境测试插入操作，确认不再触发IDENTITY_INSERT报错
2. 分别验证MySQL、Oracle环境下的ID生成逻辑，确保多数据库兼容性

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