Spring Boot实体保存触发非空约束失败问题排查与解决

异常原因拆解 #

你遇到的问题核心在于双向一对多关联的配置错误，导致Hibernate的持久化顺序触发了NOT NULL约束：

1. 目前你的@OneToMany注解里用了@JoinColumn(name = "schoolId")，这会让Hibernate把这个关联当成单向关联来处理——尽管你在User实体里配置了@ManyToOne，但这种配置会让Hibernate认为School是外键的维护方。
2. 当执行schoolRepository.save(school)时，Hibernate会先尝试插入User记录，但此时School的主键还未生成（或者说Hibernate没有自动把School的ID关联到User的schoolId字段），导致插入User时school_id为null。
3. 在你通过Liquibase添加NOT NULL约束前，数据库允许school_id为null，Hibernate会先插入User（带null的school_id），之后再更新User的school_id为School的主键；但添加约束后，第一步插入就直接违反了非空规则，抛出异常。

解决方案 #

只需要两步就能解决这个问题：

1. 修正School实体的@OneToMany配置

双向一对多关联中，应该由**多的一方（User）**来维护外键关系。所以你需要把School里的@OneToMany改成用mappedBy属性关联User中的school字段，去掉多余的@JoinColumn：

@OneToMany(cascade = CascadeType.ALL, fetch = FetchType.EAGER, targetEntity = User.class, mappedBy = "school")
private List<User> users;

这个配置告诉Hibernate：User实体的school字段是这个双向关联的维护方，外键的赋值和更新都由User来处理。

2. 保存前手动关联User到School

在保存School之前，要确保每个User对象都设置了对应的School实例，这样Hibernate在持久化时才会自动把School的主键填充到User的school_id字段：

// 创建School实例
School school = new School();
school.setName("示例学校"); // 设置School的其他属性

// 创建并关联User
List<User> users = new ArrayList<>();
User user = new User();
user.setName("示例用户"); // 设置User的其他属性
user.setSchool(school); // 关键：把User关联到当前School
users.add(user);

school.setUsers(users);
// 执行保存操作
schoolRepository.save(school);

这样修改后，Hibernate会先保存School（生成主键），再保存关联的User，此时User的school_id会被自动填充为School的主键，完全符合非空约束的要求。

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