PostgreSQL下Hibernate pooled-lo优化器序列约束冲突问题

看起来你遇到了Hibernate pooled-lo优化器配合PostgreSQL序列时的主键冲突问题，我帮你拆解下核心原因和解决步骤：

核心问题定位 #

第11次保存触发约束冲突，大概率是这几个关键点出了问题：

• 数据库序列增量与Hibernate配置不匹配：pooled-lo优化器要求数据库序列的INCREMENT BY值和Hibernate的increment_size完全一致。如果序列实际增量不是10，Hibernate本地缓存的ID池会和数据库生成的序列值重叠。
• 序列起始值未对齐现有数据：从IDENTITY切换到SEQUENCE时，序列当前值没同步表中最大ID，导致新生成的ID和已有数据撞车。
• 自定义@SQLInsert的潜在隐患：虽然你的insert语句包含了ID参数，但check=ResultCheckStyle.NONE可能让Hibernate无法及时感知主键生成的异常。

分步解决办法 #

1. 先修正数据库序列配置 #

登录PostgreSQL，先查清楚序列的当前状态：

SELECT sequence_name, start_value, increment_by, last_value 
FROM information_schema.sequences 
WHERE sequence_name = 'report_calls_idreportcall_seq';

要确保：

• increment_by的值是10，和Hibernate里的increment_size完全一致
• 如果序列的last_value小于表中最大的idreportcall，立刻更新序列起始值：

-- 先查表里的最大ID
SELECT MAX(idreportcall) FROM public.report_calls;
-- 把序列下一个值设为「最大ID + 10」（和增量保持一致）
ALTER SEQUENCE report_calls_idreportcall_seq RESTART WITH [你的最大ID + 10];

2. 简化Hibernate主键生成配置（推荐） #

Hibernate 5.2+支持用标准JPA的@SequenceGenerator直接配置pooled-lo优化器，比@GenericGenerator更简洁不容易出错：

@Id
@SequenceGenerator(
    name = "report_calls_seq",
    sequenceName = "report_calls_idreportcall_seq",
    initialValue = 1,
    allocationSize = 10,
    optimizer = "pooled-lo"
)
@GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "report_calls_seq")
@Column(name = "idreportcall", nullable = false)
private long id;

3. 调整自定义@SQLInsert的检查策略 #

把check=ResultCheckStyle.NONE改成ResultCheckStyle.EXCEPTION，这样Hibernate能在插入失败时立刻抛出异常，方便排查问题：

@SQLInsert(
    sql = "INSERT INTO public.report_calls (dateadded, dateend, datestart, idmelody, idregion, idmelodytype, msisdn_a, msisdn_b, idvoicechannel, idreportcall) VALUES (?,?,?,?,?,?,?,?,?,?)",
    check = ResultCheckStyle.EXCEPTION
)

4. 验证pooled-lo的工作逻辑 #

pooled-lo的逻辑是：第一次拿序列值N，就用N到N+9这10个ID；用完后才会再调用nextval拿N+10。如果第11次还冲突，那肯定是序列增量和Hibernate配置不一致，再回去检查数据库序列的increment_by。

测试验证 #

改完配置重启应用，跑11次保存，看日志：

• 第一次会调用select nextval ('report_calls_idreportcall_seq')拿到初始值
• 前10次用本地缓存的ID，不会再查序列
• 第11次才会再次调用nextval，拿到下一个序列值，此时插入的ID应该不会和之前的冲突

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