Hibernate 5.4+PostgreSQL 10自增主键失效问题求助

我来帮你排查下这个问题，结合Hibernate 5.4和PostgreSQL 10的特性，大概率是这几个地方出了问题，咱们一步步来解决：

1. 验证PostgreSQL序列的实际定义是否匹配配置 #

你已经创建了warehouses_id_seq序列，但要确保它的起始值、增量值和你在@SequenceGenerator里设置的allocationSize=1一致。

先执行SQL查看序列参数：

SELECT start_value, increment_by, data_type FROM warehouses_id_seq;

如果输出的start_value不是1，或者increment_by不是1，或者data_type和你的实体类ID类型（Integer）不匹配，就需要修改序列：

-- 如果是Integer类型的序列
ALTER SEQUENCE warehouses_id_seq 
START WITH 1 
INCREMENT BY 1 
AS INTEGER;

2. 检查Hibernate的生成器映射配置 #

Hibernate 5.x默认启用新的生成器映射，但如果你的配置文件里手动禁用了，会导致序列生成策略异常。

在你的Hibernate配置文件（比如hibernate.cfg.xml）或者Spring的application.properties里，确保以下配置存在：

# application.properties 示例
hibernate.id.new_generator_mappings=true

这个参数决定了Hibernate使用新的序列生成逻辑，和PostgreSQL的序列兼容性更好。

3. 避免手动设置ID字段值 #

保存实体时，千万不要手动给id赋值，否则会覆盖Hibernate自动生成的序列值：

Warehouse warehouse = new Warehouse();
// 错误示例：不要手动设置id
// warehouse.setId(100);
entityManager.persist(warehouse); // 正确做法，让Hibernate自动生成

4. 可选：确保数据库表的ID字段关联序列（增强兼容性） #

虽然Hibernate的SEQUENCE策略会自己调用nextval()获取序列值，但如果你的表结构里ID字段没有设置默认值关联序列，可能会出现一些边缘问题。可以修改表结构：

ALTER TABLE warehouses 
ALTER COLUMN id SET DEFAULT nextval('warehouses_id_seq');

同时确保ID字段是NOT NULL：

ALTER TABLE warehouses 
ALTER COLUMN id SET NOT NULL;

优化建议：改用Long类型作为ID #

PostgreSQL的序列默认是bigint类型，如果你用Integer作为ID，后续数据量增大时容易出现溢出问题。建议把实体类的ID类型改成Long，同时调整序列的类型：

@Entity
@Table(name = "warehouses")
@SequenceGenerator(
    name = "SEQUENCE_WAREHOUSE",
    sequenceName = "warehouses_id_seq",
    allocationSize = 1
)
public class Warehouse implements Serializable {
    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "SEQUENCE_WAREHOUSE")
    @Column(name = "id", nullable = false)
    private Long id; // 改用Long更稳妥
    
    // 其他字段、构造方法和getter/setter
}

对应的序列修改：

ALTER SEQUENCE warehouses_id_seq 
START WITH 1 
INCREMENT BY 1 
BIGINT;

按照上面的步骤排查后，应该就能解决主键无法自增的问题了。

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