H2数据库ID字段为空错误解决方法

本文针对在使用 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

在使用 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;

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

• @GeneratedValue(strategy = GenerationType.IDENTITY)： 这个注解告诉 JPA 使用数据库的自增长特性来生成 ID。

总结与注意事项

• 当使用 GenerationType.IDENTITY 时，务必确保数据库表中的 ID 列被定义为自增长的标识列。
• 避免在代码中手动设置 ID 的值，让数据库自动生成 ID。
• 根据需要，可以使用 GENERATED ALWAYS AS IDENTITY 来强制禁止手动插入 ID 值。
• 仔细检查实体类的配置，确保 @GeneratedValue 注解的 strategy 属性设置为 GenerationType.IDENTITY。

通过以上步骤，你应该能够解决 "NULL not allowed for column 'ID'" 错误，并正确使用 H2 数据库的自增长特性。如果问题仍然存在，请仔细检查数据库连接配置、事务管理以及其他可能的配置错误。