Spring Boot中使用JPA向H2内存数据库插入数据时遭遇约束违规问题求助

看来你卡在了H2数据库插入数据的主键非空问题上，我来帮你理清楚原因和解决办法：

问题根源 #

你定义的Role实体类用了Hibernate的UUIDGenerator来生成主键，但这个生成逻辑是在Java应用层完成的，并不是数据库原生的自动主键生成机制。当你通过data.sql直接执行插入语句时，绕开了Hibernate的主键生成逻辑，而H2数据库本身并没有被配置为自动填充role_id字段，再加上该字段是主键（自带非空约束），所以就抛出了NULL not allowed for column "ROLE_ID"的异常。

三种可行的解决方案 #

方案一：在插入语句中手动指定UUID值

直接在data.sql里给role_id字段提供一个UUID值，H2支持直接使用UUID()函数生成随机UUID，修改后的SQL如下：

insert into roles(role_id, name) values(UUID(), 'ROLE_ADMIN');

你也可以手动写一个固定的UUID字符串，比如：

insert into roles(role_id, name) values('f47ac10b-58cc-4372-a567-0e02b2c3d479', 'ROLE_ADMIN');

方案二：修改实体类，让数据库自动生成UUID

调整Role实体的主键生成策略，让Hibernate告诉H2数据库自动生成UUID主键。修改后的Role实体ID部分代码如下：

@Id
@GeneratedValue(strategy = GenerationType.AUTO)
@Column(name = "role_id", updatable = false)
private UUID uuid;

或者更精准地指定H2兼容的UUID生成器：

@Id
@GeneratedValue(generator = "uuid2")
@GenericGenerator(name = "uuid2", strategy = "uuid2")
@Column(name = "role_id", columnDefinition = "BINARY(16)")
private UUID uuid;

这样修改后，你原来的data.sql插入语句不需要改动，H2会自动为role_id生成UUID值。

方案三：通过Hibernate的SQL插入（替代data.sql）

如果你不想修改SQL或实体类，也可以编写一个启动时的初始化组件，通过JPA的EntityManager或者Repository来插入角色数据，这样就能利用Hibernate的UUID生成逻辑：

@Component
public class DataInitializer implements ApplicationRunner {

    private final RoleRepository roleRepository;

    public DataInitializer(RoleRepository roleRepository) {
        this.roleRepository = roleRepository;
    }

    @Override
    public void run(ApplicationArguments args) throws Exception {
        if (roleRepository.findByName("ROLE_ADMIN").isEmpty()) {
            Role adminRole = new Role();
            adminRole.setName("ROLE_ADMIN");
            roleRepository.save(adminRole);
        }
    }
}

这个方法的好处是完全遵循JPA的逻辑，不会出现数据库层面的约束冲突。

验证方法 #

修改完成后启动项目，打开H2控制台（默认地址http://localhost:8080/h2-console），输入你配置的数据库连接信息，查看roles表是否成功插入数据，同时检查控制台是否再无异常输出。

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