如何在Spring Boot JPA中保存值为Null的外键？

我来帮你分析下问题的核心，然后给出具体的解决办法：

问题根源 #

你当前的代码里，@ManyToOne注解用了cascade = CascadeType.ALL，这是关键问题！CascadeType.ALL包含了PERSIST（持久化）操作——如果你的主实体中ref属性不是真正的null，而是一个新建的空Reference对象（哪怕所有字段都为空），JPA会自动触发这个空对象的持久化，生成主键后把它关联到主表的外键列里。

而optional=true只是告诉数据库这个外键列允许为null，但不代表JPA会自动忽略非null的关联对象。

解决方案1：调整级联类型（最直接有效） #

如果你不需要在保存主实体时自动保存关联的Reference对象，直接去掉cascade = CascadeType.ALL（默认情况下JPA不会做任何级联操作），或者根据实际需求选择更合适的级联类型（比如CascadeType.MERGE、CascadeType.REFRESH）。

修改后的代码示例：

@JsonIgnoreProperties({"courses","handler","hibernateLazyInitializer"})
@ManyToOne(optional = true)
@JoinColumn(name = "ref_id", columnDefinition = "Long default null")
private Reference ref;

同时要确保：在保存主实体之前，把ref属性明确设置为null，而不是一个空的Reference实例。

解决方案2：保留级联但仅在必要时触发 #

如果你因为业务需求必须保留级联，但只想在ref是已持久化的对象（有主键ID）时才触发级联，那么可以把级联类型改成仅包含MERGE和REFRESH，去掉PERSIST（CascadeType.ALL包含了它）：

@JsonIgnoreProperties({"courses","handler","hibernateLazyInitializer"})
@ManyToOne(cascade = {CascadeType.MERGE, CascadeType.REFRESH}, optional = true)
@JoinColumn(name = "ref_id", columnDefinition = "Long default null")
private Reference ref;

这样当ref是无ID的空对象时，JPA不会自动持久化它，只要你把ref设为null，外键列就会保存null。

额外注意：前端传参的处理 #

如果前端传过来的是{"ref": {}}这种空对象，而不是{"ref": null}，Jackson会把它反序列化成一个空的Reference实例（而非null），这时候即使你调整了级联，还是可能出现意外的关联。解决办法：

1. 开启Jackson的DeserializationFeature.ACCEPT_EMPTY_OBJECT_AS_NULL_BEAN配置，让空对象自动转为null；
2. 在实体的setter方法里做判断，把空对象转为null：

   public void setRef(Reference ref) {
       // 如果Reference对象没有主键ID，就设为null
       if (ref != null && ref.getId() == null) {
           this.ref = null;
       } else {
           this.ref = ref;
       }
   }
   

最后验证数据库列 #

虽然你设置了columnDefinition="Long default null"，但最好手动确认数据库中的ref_id列确实被设置为允许null，避免因为历史迁移脚本或数据库约束导致的配置不生效。

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