使用Hibernate Envers时hibernate_sequence生成重复主键问题

DevOps 小满

2026-7-6

问题分析

线上OpenShift多实例环境下，Hibernate Envers生成的revision_id偶发重复，核心原因是序列缓存配置与数据库序列增量不匹配，加上多实例场景下的缓存值重叠；另外可能存在Hibernate方言配置错误、序列生成器未被正确绑定的问题。

解决方案

1. 修正序列生成器绑定与配置

AuditRevisionEntity继承自DefaultRevisionEntity，其默认的id字段未指定自定义序列生成器，导致Hibernate使用默认配置。需显式重写id字段并绑定自定义生成器，同时指定allocationSize与数据库序列增量一致：

@Getter
@Setter
@Entity
@NoArgsConstructor
@AllArgsConstructor
@Table(name = "revision_info")
@RevisionEntity(AuditRevisionListener.class)
@SequenceGenerator(
    name = "revision_seq",
    sequenceName = "hibernate_sequence",
    allocationSize = 50 // 需与数据库序列INCREMENT BY值一致
)
@AttributeOverride(name = "timestamp", column = @Column(name = "rev_timestamp"))
@AttributeOverride(name = "id", column = @Column(name = "revision_id"))
@JsonIgnoreProperties({"hibernateLazyInitializer", "handler"})
public class AuditRevisionEntity extends DefaultRevisionEntity {

    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "revision_seq")
    @RevisionNumber
    private int id;

    @Column(name = "user")
    private String user;

    @Override
    public boolean equals(Object obj) {
        if (!super.equals(obj)) {
            return false;
        }
        return user.equals(((AuditRevisionEntity) obj).getUser());
    }

    @Override
    public int hashCode() {
        return Objects.hash(super.hashCode(), user);
    }
}

2. 同步数据库序列增量

执行SQL语句修改hibernate_sequence的增量值，使其与代码中allocationSize一致：

ALTER SEQUENCE hibernate_sequence INCREMENT BY 50;

若数据库中序列不存在，需先创建：
CREATE SEQUENCE hibernate_sequence START WITH 1 INCREMENT BY 50;

3. 配置正确的MariaDB方言

在application.properties或application.yml中指定对应版本的MariaDB方言，避免Hibernate对序列的处理逻辑错误：

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

4. 验证集群环境下的序列隔离

若OpenShift部署了多个应用实例，确保每个实例的Hibernate序列缓存不会重叠：

禁止将allocationSize设为1（会导致频繁访问数据库，且多实例下仍可能出现冲突）
确保所有实例使用相同的allocationSize配置，且与数据库序列增量严格匹配

验证步骤

重启所有OpenShift应用实例
触发多次数据持久化操作，检查revision_info表的revision_id是否连续且无重复
手动执行SELECT nextval('hibernate_sequence')，确认序列值按设定增量递增

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