IntelliJ运行Spring Boot JPA应用报非空属性空值引用异常，终端运行正常

问题描述 #

基于Spring Boot 2.6.2、JPA、H2数据库（Java 17）的微服务项目，在IntelliJ中运行时插入数据抛出异常：

Caused by: org.hibernate.PropertyValueException: not-null property references a null or transient value

但命令行或STS中运行完全正常，数据可正常插入。本地H2数据源配置如下：

spring:
  datasource:
    url: jdbc:h2:mem:test;DB_CLOSE_ON_EXIT=TRUE;DB_CLOSE_DELAY=5
    driverClassName: org.h2.Driver
    username: admin
    password: admin

项目还配置了Flyway，但仅在dev环境生效，报错关联的HostLineUser字段在Employee实体中标记了错误。

核心原因 #

从实体映射来看，Employee和HostLineUser是双向一对一关联：

• Employee中hostLineUser字段用@OneToOne(mappedBy = "user")，说明HostLineUser是关联的拥有方（维护外键USER_ID）
• HostLineUser中employee字段的@JoinColumn(name = "USER_ID", nullable = false)强制外键非空

问题出在双向关联的对象关系未正确维护，且IntelliJ的运行环境可能触发了更严格的Hibernate校验（比如默认的hibernate.check_nullability配置差异）：

1. 保存Employee时，若仅设置employee.setHostLineUser(hostLineUser)，但未反向设置hostLineUser.setEmployee(employee)，Hibernate会认为HostLineUser的employee字段为null，违反非空约束
2. 命令行/STS运行时可能因为配置差异（比如Hibernate校验开关）或数据初始化顺序不同，绕过了这个校验

解决方案 #

1. 维护双向关联的一致性 #

在设置关联关系时，必须同时维护双方的引用，建议在实体的setter方法中添加同步逻辑：

// 在Employee类中修改setHostLineUser方法
public void setHostLineUser(HostLineUser hostLineUser) {
    this.hostLineUser = hostLineUser;
    if (hostLineUser != null) {
        hostLineUser.setEmployee(this);
    }
}

// 或者在HostLineUser类中修改setEmployee方法
public void setEmployee(Employee employee) {
    this.employee = employee;
    if (employee != null && !employee.getHostLineUser().equals(this)) {
        employee.setHostLineUser(this);
    }
}

这样在设置关联时，自动同步双方的引用，避免出现单方为null的情况。

2. 检查IntelliJ的运行配置差异 #

• 确认IntelliJ运行时使用的是正确的application.yml配置，没有激活额外profile导致Hibernate配置变化
• 检查IntelliJ的VM参数是否添加了影响Hibernate的配置，比如-Dhibernate.check_nullability=true（命令行可能默认未开启）

3. 调整关联映射的非空约束（可选） #

如果业务允许HostLineUser独立存在，可将HostLineUser中employee字段的nullable改为true：

@JoinColumn(name = "USER_ID", nullable = true)
private Employee employee;

注：此修改需结合业务场景判断，若业务要求两者必须绑定，不建议调整。

4. 确保保存顺序正确 #

若手动处理保存逻辑，应先保存Employee（获取生成的ID），再设置HostLineUser的employee引用后保存HostLineUser；或者利用CascadeType.ALL让Hibernate自动处理，但前提是双向引用已正确维护。

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