执行INSERT语句遇ID列非空异常？Hibernate序列未关联ID列排查

这个问题我之前在项目里也碰到过，主要是两个原因导致的，咱们慢慢捋清楚：

1. 手动插入未提供主键值 #

你的MyEntity实体里的ID是标记为@Id的主键字段，对应数据库表的ID列必然带有NOT NULL约束。当你直接执行INSERT语句时完全没指定ID的值，数据库肯定会抛出NULL not allowed for column "ID"的异常——毕竟主键绝对不能是空值。

2. Hibernate的DDL更新未关联序列与ID列 #

你配置了hibernate.hbm2ddl.auto=update和spring.jpa.hibernate.ddl-auto=update，但update模式下Hibernate的行为比较保守，有时候不会自动把你定义的序列和ID列的默认值绑定起来。简单说就是：数据库知道有MY_ENTITY_SEQ这个序列，但不会自动用它的下一个值来填充空的ID字段，所以手动插入时必须显式给ID赋值。

方案一：手动插入时从序列取ID值 #

根据你使用的数据库类型，执行插入语句时主动从序列获取下一个值：

• PostgreSQL示例：

INSERT INTO PUBLIC.MY_ENTITY (id, name) VALUES (nextval('MY_ENTITY_SEQ'), 'test name');

• Oracle示例：

INSERT INTO PUBLIC.MY_ENTITY (id, name) VALUES (MY_ENTITY_SEQ.NEXTVAL, 'test name');

方案二：修正实体配置+手动绑定序列与ID列 #

首先补全你实体类中不完整的序列生成器配置，确保Hibernate能正确识别：

@Entity
@Table(name = "MY_ENTITY")
public class MyEntity {
    @Id
    @SequenceGenerator(
        sequenceName = "MY_ENTITY_SEQ", 
        name = "MyEntitySeq",
        allocationSize = 1 // 不需要批量分配ID的话设为1，避免序列跳号
    )
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "MyEntitySeq")
    private Long id; // 根据你的实际字段类型调整，比如Integer

    private String name;

    // 构造器、getter、setter请自行补充
}

然后手动修改数据库表结构，让ID列默认从序列取值（因为update模式可能不会自动完成这一步）：

• PostgreSQL：

ALTER TABLE PUBLIC.MY_ENTITY 
ALTER COLUMN id SET DEFAULT nextval('MY_ENTITY_SEQ');

• Oracle（12c+支持直接设默认值，低版本需要触发器）：

ALTER TABLE PUBLIC.MY_ENTITY 
MODIFY id DEFAULT MY_ENTITY_SEQ.NEXTVAL;

修改完成后，再执行不带ID的INSERT语句就不会报错了。

方案三：改用自增主键策略（如果适配你的数据库） #

如果你的数据库支持自增列（比如MySQL的AUTO_INCREMENT、PostgreSQL的BIGSERIAL），可以把ID生成策略改成IDENTITY，这样Hibernate会让数据库自动管理主键自增，手动插入时也不用指定ID：

@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;

不过这个策略和序列策略各有优缺点，比如IDENTITY在批量插入时性能可能略差，根据你的项目需求选择就好。

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