EclipseLink GenerationType.AUTO策略生成已存在ID问题如何解决

PostgreSQL搭配EclipseLink使用GenerationType.AUTO主键生成策略时，默认通过独立的数据库序列对象生成ID，不会每次插入前主动查询表内现有最大ID值。之前手动插入数据时直接指定了ID，没有同步更新对应序列的计数位置，当序列自增到已经被手动插入占用的ID值时，就会抛出主键重复的错误。

• 第一步：校准关联序列的当前值
  首先查询目标表现有最大ID：

  SELECT MAX(id) FROM 你的目标表名;
  

  再查询该表ID列绑定的序列名称，EclipseLink默认生成的序列名通常为表名_seq，也可以通过以下SQL直接查询：

  SELECT pg_get_serial_sequence('你的目标表名', 'ID');
  

  拿到序列名后，执行语句将序列的下一个生成值调整为和表内最大ID对齐：

  SELECT setval('你查到的序列名', (SELECT MAX(id) FROM 你的目标表名));
  

  后续如果需要手动插入数据，不要硬编码指定ID值，改用nextval('对应序列名')作为ID取值，就不会打乱序列的计数节奏。
• 第二步：优化实体类ID生成配置，避免默认策略的不确定性
  不要使用GenerationType.AUTO，显式指定序列生成规则，确保框架配置和数据库实际规则对齐：

  @Id
  @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "biz_table_seq")
  @SequenceGenerator(name = "biz_table_seq", sequenceName = "数据库中实际的序列名", allocationSize = 1)
  @Column(name = "ID")
  protected long id = 0L;
  

  注意allocationSize的值要和PostgreSQL中序列的自增步长保持一致，PostgreSQL默认步长为1，这里配置为1即可，避免框架内存预分配的ID段和数据库序列实际值错位。
• 可选方案：如果表的ID列是bigserial/serial类型，也可以改用IDENTITY生成策略，让数据库完全托管主键生成逻辑，减少框架侧预生成ID带来的不一致问题：

  @Id
  @GeneratedValue(strategy = GenerationType.IDENTITY)
  @Column(name = "ID")
  protected long id = 0L;
  

  注意采用这个方案依然需要先执行第一步的序列校准操作，否则还是会触发主键冲突。

注意：不要通过应用启动时扫描全表最大ID的方式修复问题，这类方案在并发插入场景下会出现计数不准、锁表、性能差的问题，数据库序列本身就是为并发场景生成唯一ID设计的，只要保证序列计数和表内实际数据对齐，就不会重复出现主键冲突。

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