Hibernate子类重复生成器序列问题：重复生成器名称异常

嘿，这个重名生成器的问题我之前帮不少开发者踩过坑，本质就是Hibernate的上下文里重复注册了同一个名称的ID生成器，咱们一步步来排查修复：

1. 先检查父类与子类的生成器配置冲突 #

看你的抽象父类EntityId，如果它里面已经用@SequenceGenerator定义了名为idgen的生成器，然后子类又重复用了同一个名称来定义自己的序列生成器，就会直接触发这个异常。举个常见的错误例子：

父类里的配置：

@MappedSuperclass
public abstract class EntityId<T extends Serializable> implements Serializable {
    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "idgen")
    @SequenceGenerator(name = "idgen", sequenceName = "base_seq")
    private T id;
    // ...其他代码
}

子类又跟着定义：

@Entity
@Table(name = "child_table")
@SequenceGenerator(name = "idgen", sequenceName = "child_seq")
public class ChildEntity extends EntityId<Long> {
    // ...子类属性
}

这种情况下，父类的idgen和子类的idgen会被Hibernate同时注册，自然就冲突了。

修复方案： #

• 方案一：父类不指定具体生成器，让子类自定义
  把父类里的生成器配置去掉，只保留基础的ID注解，让每个子类自己定义专属的生成器：

@MappedSuperclass
public abstract class EntityId<T extends Serializable> implements Serializable {
    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE) // 这里不指定generator，交给子类处理
    private T id;
    // ...其他代码
}

子类配置自己的唯一生成器：

@Entity
@Table(name = "child_table")
@SequenceGenerator(name = "child_idgen", sequenceName = "child_seq", allocationSize = 1)
public class ChildEntity extends EntityId<Long> {
    // ...子类属性
}

• 方案二：用@AttributeOverride覆盖父类的生成器
  如果父类必须保留生成器配置，那子类可以通过@AttributeOverride来指定自己的专属生成器，注意名称要唯一：

@Entity
@Table(name = "child_table")
@SequenceGenerator(name = "child_idgen", sequenceName = "child_seq")
public class ChildEntity extends EntityId<Long> {
    @Override
    @AttributeOverride(name = "id", column = @Column(name = "id"))
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "child_idgen")
    private Long id;
    // ...子类属性
}

2. 排查pom.xml的依赖冲突 #

有时候重复引入Hibernate相关依赖，或者不同版本的Hibernate共存，也会导致内部组件重复注册生成器。比如同时引入hibernate-core和hibernate-entitymanager（新版本里后者已经合并到前者了），就容易出问题。

修复方案： #

• 清理pom.xml，只保留核心的Hibernate依赖，并且版本统一：

<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-core</artifactId>
    <version>5.6.14.Final</version> <!-- 选一个稳定的统一版本 -->
</dependency>

• 运行mvn dependency:tree查看依赖树，排除掉重复或者冲突的依赖项。

3. 检查XML配置文件是否重复定义生成器 #

如果你同时用了注解和XML配置（比如hibernate.cfg.xml或persistence.xml），要确保两边没有定义同名的生成器。比如XML里已经定义了<generator name="idgen" ...>，同时注解里也用了generator="idgen"，就会冲突。

修复方案： #

• 尽量保持配置方式统一，要么全用注解，要么全用XML；
• 如果必须混合使用，确保生成器名称完全不重复。

4. 检查多个子类是否共用同一个生成器名称 #

如果有多个子类都把生成器名称设为idgen，那每个子类都会向Hibernate注册一个同名的生成器，必然会报错。

修复方案： #

给每个子类的生成器起个唯一的名字，比如user_seq_gen、order_seq_gen，对应各自的数据库序列就行。

总结 #

核心就是一句话：同一个Hibernate SessionFactory里，每个ID生成器的名称必须唯一。只要把所有重复的idgen名称改成各自唯一的，这个异常就搞定了。

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