Hibernate执行INSERT IGNORE无操作时返回身份值生成错误

问题场景 #

当使用INSERT IGNORE语句因commission_id和type的唯一键重复导致插入被忽略时，Hibernate抛出The database returned no natively generated identity value错误；正常插入操作可正常执行，但即使插入被忽略，数据库的自增ID仍会递增（例如首次插入ID为1，报错后再次插入新数据ID变为3）。

相关代码与表结构 #

Java实体类 #

@Entity
@Getter
@AllArgsConstructor
@NoArgsConstructor(force = true)
@With
@ToString
@Table(name = "commission_warning", uniqueConstraints = {@UniqueConstraint(columnNames = {"commission_id", "type"})})
@SQLInsert(sql = "INSERT IGNORE INTO commission_warning (commission_id, type) VALUES (?, ?)")
public class CommissionWarning {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private final Long id;

    @ManyToOne
    private final Commission commission;
    @Enumerated(EnumType.STRING)
    private final CommissionWarningType type;
}

MySQL表结构 #

CREATE TABLE `commission_warning` (
  `id` bigint NOT NULL AUTO_INCREMENT,
  `type` varchar(255) DEFAULT NULL,
  `commission_id` bigint DEFAULT NULL,
  PRIMARY KEY (`id`),
  UNIQUE KEY `UKbffm7pdogka4homn1e47fasw` (`commission_id`,`type`),
  CONSTRAINT `FKtg3yujdt6esjrwmer7cdsyalw` FOREIGN KEY (`commission_id`) REFERENCES `commission` (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci

原因解析 #

• Hibernate ID生成逻辑冲突：当使用GenerationType.IDENTITY策略时，Hibernate要求数据库在插入后返回新生成的自增ID，用于填充实体的id字段。但INSERT IGNORE在遇到唯一键冲突时，仅返回受影响行数0，不会返回任何生成的ID，导致Hibernate无法获取到预期的身份值，抛出错误。
• MySQL AUTO_INCREMENT机制特性：MySQL的自增序列是独立于插入操作结果的——即使插入被忽略（或失败），自增计数器仍会自动递增，这就是后续插入ID跳号的原因。
• 自定义插入语句的副作用：@SQLInsert覆盖了Hibernate默认的插入逻辑，Hibernate无法再自动处理唯一键冲突场景，完全依赖自定义的INSERT IGNORE，但它本身的ID生成逻辑仍在等待数据库返回有效ID值，两者逻辑不匹配导致报错。

可选解决方案 #

• 移除自定义插入语句：删除@SQLInsert注解，让Hibernate使用默认插入逻辑，同时在业务层捕获SQLIntegrityConstraintViolationException异常，处理重复插入场景。
• 修改插入语句兼容ID返回：将INSERT IGNORE改为INSERT ... ON DUPLICATE KEY UPDATE，通过无意义的更新触发679048返回已存在的ID，让Hibernate能获取到合法值。修改后的注解语句如下：

  @SQLInsert(sql = "INSERT INTO commission_warning (commission_id, type) VALUES (?, ?) ON DUPLICATE KEY UPDATE id=LAST_INSERT_ID(id)")
  

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