如何配置JPA避免插入数据库列默认值生成的主键ID？

针对PostgreSQL列已配置DEFAULT默认值的主键（比如序列生成的数值ID、UUID生成函数的UUID ID），要让JPA+Hibernate不主动插入主键值，而是由数据库生成，可按以下场景配置：

1. 数值型主键（基于序列DEFAULT） #

如果你的表主键列用序列的nextval作为默认值，比如：

CREATE TABLE your_table (
    id bigint DEFAULT nextval('your_table_id_seq') PRIMARY KEY,
    -- 其他字段
);

实体类需配置序列生成策略，明确绑定数据库中的序列：

@Entity
@Table(name = "your_table")
public class YourEntity {
    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "your_table_id_generator")
    @SequenceGenerator(
        name = "your_table_id_generator",
        sequenceName = "your_table_id_seq", -- 必须和数据库序列名一致
        allocationSize = 1 -- 匹配PostgreSQL序列默认步长，避免预分配导致的ID不连续
    )
    private Long id;

    // 其他字段、构造器、getter/setter
}

2. UUID型主键（基于DEFAULT生成函数） #

如果主键是UUID类型，数据库列默认用uuid_generate_v4()生成，比如：

CREATE TABLE your_uuid_table (
    id uuid DEFAULT uuid_generate_v4() PRIMARY KEY,
    -- 其他字段
);

Hibernate 5.4及以上版本可直接用内置UUID生成策略：

@Entity
@Table(name = "your_uuid_table")
public class YourUuidEntity {
    @Id
    @GeneratedValue(strategy = GenerationType.UUID)
    private UUID id;

    // 其他字段、构造器、getter/setter
}

如果是低版本Hibernate，可使用原生UUID生成器：

@Id
@GeneratedValue(generator = "pg-uuid")
@GenericGenerator(name = "pg-uuid", strategy = "org.hibernate.id.UUIDGenerator")
private UUID id;

关键注意事项 #

• 不要手动赋值主键：插入实体前必须保证id字段为null，否则Hibernate会优先使用你设置的值，忽略数据库默认值。
• 避免DDL覆盖数据库配置：如果用Spring Boot，需设置spring.jpa.hibernate.ddl-auto=validate（或none），防止Hibernate自动生成的DDL覆盖你手动配置的列DEFAULT规则。
• 验证数据库依赖：如果用UUID生成函数，需确保PostgreSQL已启用uuid-ossp扩展（执行CREATE EXTENSION IF NOT EXISTS "uuid-ossp";）。

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