SpringBoot多对多关联实体保存时触发StackOverflowError问题

问题根源 #

从堆栈追踪能明确看到，StackOverflowError是实体类hashCode方法无限递归调用导致的：

• News类自动生成的hashCode会计算newsReactions集合的hashCode
• 集合内的NewsReactions对象的hashCode又会计算关联的News对象的hashCode
• 这种双向引用的循环计算最终耗尽栈内存，抛出异常

核心原因是你用了Lombok的@Data注解，它会自动生成包含所有字段的equals和hashCode方法，而双向关联的实体（News ↔ NewsReactions）互相引用对方，触发了无限递归。

修复方案 #

在双向关联的字段上排除equals和hashCode的计算，打断循环链：

1. 修改News.java #

给newsReactions字段添加@EqualsAndHashCode.Exclude注解：

@Data
@Entity
@Table(name = "News")
public class News {
    // 其他字段保持不变...

    @EqualsAndHashCode.Exclude // 排除该字段参与hashCode计算
    @JsonManagedReference
    @OneToMany(mappedBy="news", cascade = CascadeType.ALL)
    Set<NewsReactions> newsReactions;

    // 原有方法保持不变...
}

2. 修改NewsReactions.java #

给news和reactions字段添加@EqualsAndHashCode.Exclude注解：

@Data
@Entity
@NoArgsConstructor
public class NewsReactions {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    Long id;

    @EqualsAndHashCode.Exclude // 排除
    @ToString.Exclude
    @JsonBackReference
    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name="news_id")
    News news;

    @EqualsAndHashCode.Exclude // 排除
    @ToString.Exclude
    @JsonIgnore
    @ManyToOne
    @JoinColumn(name="reactions_id")
    Reactions reactions;

    // 其他字段和方法保持不变...
}

3. 防御性修改（可选） #

给Reactions.java的newsReactions字段也添加排除注解，避免潜在的循环问题：

@NoArgsConstructor
@Data
@Entity
@Table(name = "Reactions")
public class Reactions {
    // 其他字段保持不变...

    @EqualsAndHashCode.Exclude
    @JsonIgnore
    @OneToMany(mappedBy="reactions", fetch = FetchType.LAZY, cascade = CascadeType.ALL)
    Set<NewsReactions> newsReactions;
}

原理说明 #

@EqualsAndHashCode.Exclude会让Lombok生成的equals和hashCode方法忽略指定字段。对于JPA实体的关联字段，通常不需要将其纳入equals和hashCode的计算逻辑（一般只用ID和基础字段即可），这也是JPA实体的最佳实践之一。

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