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

风涛大大_3374

风涛大大_3374

2025-10-29

901人浏览

原创

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

Capture and search AI coding sessions alongside Git history with Entire CLI
Capture and search AI coding sessions alongside Git history with Entire CLI

在提交旁边记录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;

    // ... 其他字段和方法
}
  • @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 数据库的自增长特性。如果问题仍然存在,请仔细检查数据库连接配置、事务管理以及其他可能的配置错误。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

session

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

2023.10.12

5043

8

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.27

1031

4

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

2024.02.23

1329

5

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

7121

10

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

3763

4

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

2024.04.07

7120

11

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

2024.04.29

9961

6

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

1350

5

sql中删除一列的命令是什么
sql中删除一列的命令是什么

在sql中,使用alter table语句可以删除一列,语法为:alter table table_name drop column column_name。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

1172

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
XORM框架事务处理手册
XORM框架事务处理手册

共0课时 | 0人学习

Revel 官方 app.conf 文档
Revel 官方 app.conf 文档

共0课时 | 0人学习

Revel 官方开发手册
Revel 官方开发手册

共0课时 | 0人学习