PostgreSQL自定义ID生成下Hibernate无ID实体持久化报错解决咨询

问题背景 #

你在PostgreSQL中通过序列拼接前缀的方式设置了product表的主键默认值（格式如p1、p2），但在通过Hibernate持久化无ID的Product实体时，因为没有配置@GeneratedValue生成策略，触发了IdentifierGenerationException。核心矛盾是Hibernate要求显式指定ID生成逻辑，而你不想完全依赖Hibernate的序列生成，希望复用数据库的默认值配置。

可行解决办法 #

方案1：使用Hibernate的@Generated注解让框架读取数据库生成的ID #

修改Product实体类的ID字段配置，告诉Hibernate这个ID由数据库在插入时生成，插入后再从数据库获取值：

package com.example.productapi.data.entity;

import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import lombok.Getter;
import lombok.Setter;
import org.hibernate.annotations.Generated;
import org.hibernate.annotations.GenerationTime;

@Entity
@Getter
@Setter
public class Product {
    @Id
    @Column(name = "id", insertable = false, updatable = false)
    @Generated(GenerationTime.INSERT) // 指定插入后从数据库获取生成的ID
    private String productId;
}

• insertable = false：告诉Hibernate插入时不要包含该字段，让数据库使用默认值
• @Generated(GenerationTime.INSERT)：让Hibernate在插入完成后查询数据库获取生成的ID值

方案2：自定义ID生成器匹配数据库逻辑 #

如果希望Hibernate主动生成符合格式的ID（和数据库默认值逻辑一致），可以自定义一个标识符生成器：

首先实现Hibernate的IdentifierGenerator接口：

package com.example.productapi.data.generator;

import org.hibernate.id.IdentifierGenerator;
import org.hibernate.query.SequenceNextValueQuery;
import org.hibernate.engine.spi.SharedSessionContractImplementor;

import java.io.Serializable;

public class PrefixSequenceGenerator implements IdentifierGenerator {
    @Override
    public Serializable generate(SharedSessionContractImplementor session, Object object) {
        // 调用PostgreSQL的序列获取下一个值
        Long sequenceValue = session.createNativeQuery(
                new SequenceNextValueQuery("p_sequence").getQueryString(),
                Long.class
        ).uniqueResult();
        // 拼接前缀返回
        return "p" + sequenceValue;
    }
}

然后在实体类中指定使用这个生成器：

package com.example.productapi.data.entity;

import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import jakarta.persistence.GeneratedValue;
import lombok.Getter;
import lombok.Setter;
import org.hibernate.annotations.GenericGenerator;

@Entity
@Getter
@Setter
public class Product {
    @Id
    @GeneratedValue(generator = "p-generator")
    @GenericGenerator(name = "p-generator", type = PrefixSequenceGenerator.class)
    @Column(name = "id")
    private String productId;
}

这个方案让Hibernate和数据库使用同一个序列生成ID，避免逻辑不一致的问题。

方案3：使用@DynamicInsert让Hibernate忽略空ID字段 #

在实体类上添加@DynamicInsert注解，Hibernate会在生成INSERT语句时自动忽略值为null的字段，这样数据库就会使用预设的默认值生成ID：

package com.example.productapi.data.entity;

import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import lombok.Getter;
import lombok.Setter;
import org.hibernate.annotations.DynamicInsert;

@Entity
@Getter
@Setter
@DynamicInsert // 生成INSERT语句时忽略null字段
public class Product {
    @Id
    @Column(name = "id")
    private String productId;
}

这个方案最简单，但要注意如果后续有需要手动设置ID的场景，要确保productId不为null，否则依然会触发数据库的默认值逻辑。

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