PostgreSQL与Hibernate使用序列作为主键时出错

你遇到的错误核心原因是Hibernate错误地使用了表生成器的SQL语法去访问PostgreSQL的序列对象——PostgreSQL的序列是独立的数据库对象，并非表结构，自然不存在next_val这个列，因此触发了报错。最常见的诱因是Hibernate方言配置不正确，导致它无法识别PostgreSQL的序列机制。

1. 修正Hibernate方言配置 #

在你的persistence.xml中，必须明确指定适配PostgreSQL的Hibernate方言，让Hibernate知道如何正确与PostgreSQL的序列交互。添加或修改以下配置项：

<property name="hibernate.dialect" value="org.hibernate.dialect.PostgreSQLDialect"/>

如果你的PostgreSQL版本是9.5及以上，推荐使用更贴合版本特性的方言：

<property name="hibernate.dialect" value="org.hibernate.dialect.PostgreSQL95Dialect"/>

（更高版本的PostgreSQL可对应选择PostgreSQL10Dialect、PostgreSQL12Dialect等，根据你的数据库版本匹配即可）

2. 验证PostgreSQL序列的可用性 #

在PostgreSQL客户端执行以下SQL，确认序列能正常生成值：

SELECT nextval('player_sequence');

正常情况下，第一次执行会返回1，第二次返回21，以此类推，这说明序列创建是有效的。

3. 确认实体类注解配置的一致性 #

你的实体类ID字段的注解配置是正确的，只需确保两点：

• @SequenceGenerator的sequenceName与数据库中创建的序列名player_sequence完全一致（PostgreSQL默认对标识符大小写不敏感，除非你创建序列时加了引号，这里你的创建语句是小写，无需额外处理）
• allocationSize的值（20）与序列的INCREMENT值（20）保持一致，这能避免Hibernate与数据库之间的序列值同步问题

如果以上步骤执行后仍有问题，可以检查：

• Hibernate版本：部分老旧版本对PostgreSQL序列的支持存在bug，建议升级到5.4.x及以上的稳定版本
• 实体类ID类型：Integer的取值范围是-2^31到2^31-1，如果后续序列值可能超出这个范围，建议改用Long类型

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