Spring+Hibernate双实例部署出现主键重复异常求助

这问题我之前在分布式部署的项目里碰到过，结合你的场景（两台服务器实例、偶尔出现主键重复、用的是GenerationType.TABLE），核心原因出在TABLE主键生成策略的并发缺陷上，下面具体拆解：

为什么会出现这个异常？ #

1. TABLE生成策略的分布式并发漏洞 #

GenerationType.TABLE的工作逻辑是：Hibernate维护一张专门的序列表（默认叫hibernate_sequences），每次需要生成主键时，先查询这张表的当前序列值，然后把值递增后更新回去。

在单实例环境下，这个逻辑没问题，但多实例部署时，极容易出现并发冲突：

• 假设实例A和实例B同时处理请求，都需要生成新的Metadata主键；
• 实例A先查到序列值是100，还没来得及更新序列表，实例B也查到了同一个值100；
• 两者都用100作为主键插入数据库，就触发了MySQLIntegrityConstraintViolationException，提示主键重复。

虽然Hibernate本身会加锁来避免这个问题，但跨服务器实例的情况下，锁的有效性会打折扣，加上你说偶尔出现，说明是低概率的并发场景触发了这个漏洞（比如近期并发量略有上升，或者偶然的请求峰值）。

2. 可能的配置或隔离级别问题 #

• 如果你的Hibernate版本较低，或者hibernate.id.new_generator_mappings配置为false，旧版本的TABLE生成器实现没有足够的并发保护，更容易出现重复ID；
• 序列表所在数据库的事务隔离级别如果是读已提交，可能出现不可重复读，导致两个实例读到相同的序列值。

怎么解决这个问题？ #

根据你的场景，推荐按优先级尝试下面的方案：

方案1：改用数据库原生序列（MySQL 8.0+适用） #

MySQL 8.0及以上支持原生序列，这是分布式环境下最可靠的主键生成方式之一，数据库层面保证原子性，多实例不会冲突。修改实体类的主键注解：

@Entity @Table(name = "Metadata", catalog = "data")
public class Metadata{
    private Long id;
    // ...

    @Id 
    @Column(unique = true, nullable = false)
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "metadata_seq")
    @SequenceGenerator(name = "metadata_seq", sequenceName = "metadata_sequence", allocationSize = 1)
    public Long getId() { return id; }
    // ...
}

然后在数据库中创建序列：

CREATE SEQUENCE metadata_sequence START WITH 1 INCREMENT BY 1;

方案2：改用IDENTITY自增主键（MySQL 5.x/8.x都适用） #

如果你的MySQL版本低于8.0，或者不想维护序列，直接用自增主键，依赖数据库的AUTO_INCREMENT特性，数据库会自动保证主键唯一性：

@Entity @Table(name = "Metadata", catalog = "data")
public class Metadata{
    private Long id;
    // ...

    @Id 
    @Column(unique = true, nullable = false)
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    public Long getId() { return id; }
    // ...
}

注意：这个方案的缺点是Hibernate需要先插入记录才能获取主键值，对一些批量插入的场景性能略有影响，但胜在简单可靠。

方案3：优化TABLE生成策略（不推荐，但如果必须保留的话） #

如果你因为某些原因必须继续用TABLE策略，可以通过以下方式降低冲突概率：

• 确保hibernate.id.new_generator_mappings配置为true（Hibernate 5+默认是true），使用新版本的生成器实现；
• 增大allocationSize，让每个实例一次性获取一批ID，减少对序列表的访问次数。比如：

  @Id 
  @Column(unique = true, nullable = false)
  @GeneratedValue(strategy = GenerationType.TABLE, generator = "metadata_table")
  @TableGenerator(name = "metadata_table", table = "hibernate_sequences", allocationSize = 50)
  public Long getId() { return id; }
  

  这样每个实例每次会拿50个ID，用完再去序列表更新，大幅降低并发冲突的概率。

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