H2 数据库 ID 字段出现 NULL 值错误排查与解决-java教程-PHP中文网

H2 数据库 ID 字段出现 NULL 值错误排查与解决

花韻仙語

发布： 2025-10-29 15:57:21

原创

688人浏览过

h2 数据库 id 字段出现 null 值错误排查与解决

本文针对在使用 H2 数据库时，遇到的 "NULL not allowed for column 'ID'" 错误，提供了一种基于 `GenerationType.IDENTITY` 的解决方案。该方案的核心在于确保数据库表中的 ID 列被正确定义为自增长的标识列，并阐述了如何通过 SQL 语句进行定义，从而避免手动设置 ID 值导致的 NULL 值错误。

在使用 H2 数据库并结合 GenerationType.IDENTITY 策略进行主键自增长时，如果出现 "NULL not allowed for column 'ID'" 错误，通常是因为数据库表结构定义与实体类的配置不一致导致的。错误信息表明数据库尝试插入一个 NULL 值到 ID 列，而该列被定义为不允许 NULL 值。以下将详细介绍如何排查和解决这个问题。

问题分析

当使用 GenerationType.IDENTITY 时，数据库负责生成主键的值。这意味着你不需要，也不应该手动设置 ID 的值。如果尝试手动设置 ID 值，可能会导致与数据库的自增长机制冲突，从而引发 NULL 值错误。

解决方案

关键在于确保数据库表中的 ID 列被正确定义为自增长的标识列。这通常需要在创建表时使用特定的 SQL 语法。

1. 检查表定义

首先，检查你的 BOOK 表的定义。确保 ID 列被定义为自增长的标识列。正确的定义应该如下所示：

CREATE TABLE BOOK (
    ID BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
    AUTHOR VARCHAR(255),
    GENRE VARCHAR(255),
    ILLUSTRATOR VARCHAR(255),
    SERIES VARCHAR(255),
    TITLE VARCHAR(255)
);

登录后复制

GENERATED BY DEFAULT AS IDENTITY：这个子句告诉 H2 数据库，ID 列的值应该由数据库自动生成。BY DEFAULT 关键字允许你显式插入一个值，如果需要的话，否则数据库会生成一个值。
PRIMARY KEY：将 ID 列定义为主键。

2. 避免手动设置 ID

腾讯智影-AI数字人

基于AI数字人能力，实现7*24小时AI数字人直播带货，低成本实现直播业务快速增增，全天智能在线直播

查看详情

在使用 GenerationType.IDENTITY 时，应该避免在代码中手动设置 ID 的值。例如，以下代码是错误的，因为它尝试手动设置 ID：

@Repository
public class DAOImpl implements DAO {

    @Autowired
    private SessionFactory sessionFactory;

    public void saveBook(Book book) {
        // 错误的做法：手动设置 ID
        book.setId(0L);

        Session s = sessionFactory.getCurrentSession();
        s.save(book);
    }
}

登录后复制

正确的做法是移除 book.setId(0L); 这一行代码，让数据库自动生成 ID。

@Repository
public class DAOImpl implements DAO {

    @Autowired
    private SessionFactory sessionFactory;

    public void saveBook(Book book) {
        // 正确的做法：让数据库自动生成 ID
        Session s = sessionFactory.getCurrentSession();
        s.save(book);
    }
}

登录后复制

3. 使用 GENERATED ALWAYS AS IDENTITY (可选)

如果你希望完全禁止手动插入 ID 值，可以使用 GENERATED ALWAYS AS IDENTITY。这样，任何尝试手动插入 ID 值的操作都会导致错误。

CREATE TABLE BOOK (
    ID BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
    AUTHOR VARCHAR(255),
    GENRE VARCHAR(255),
    ILLUSTRATOR VARCHAR(255),
    SERIES VARCHAR(255),
    TITLE VARCHAR(255)
);

登录后复制

4. 检查实体类配置

确保你的实体类配置正确使用了 GenerationType.IDENTITY：

@Entity
@Table(name = "BOOK")
public class Book {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "ID")
    private Long id;

    // ... 其他字段和方法
}

登录后复制