Spring Boot JPA更新含EntityListener的实体时触发StackOverflowError

问题根源分析 #

你猜的没错，这个栈溢出确实是双向实体关联+JPA审计的循环调用导致的：

1. 当你更新GalleryReply时，JPA审计会触发AuditorAwareImpl.getCurrentAuditor()来获取当前用户；
2. 你的getCurrentAuditor()通过memberService.findByEmail()加载完整的Member实体；
3. 如果Member和GalleryReply是双向关联（比如Member有List<GalleryReply>，GalleryReply有Member createdBy），JPA加载Member时会触发关联的GalleryReply加载（哪怕是懒加载，某些场景下也会被触发）；
4. 加载GalleryReply时，审计机制又会再次调用getCurrentAuditor()，如此循环往复，最终导致StackOverflowError。

解决方案 #

根据业务需求，你可以选择以下几种方案：

方案1：改用简单类型作为审计字段（最推荐）

如果业务不需要在审计字段中存储完整的Member实体，只需要记录用户标识（比如邮箱、ID），可以直接修改审计字段的类型，避免加载实体：

• 修改CoreConfig中的AuditorAware泛型：

  @EnableJpaAuditing(dateTimeProviderRef="dateTimeProvider")
  @Configuration
  public class CoreConfig {
      @Bean
      public AuditorAware<String> auditorAware(){ // 泛型改为String（邮箱类型）
          return new AuditorAwareImpl();
      }
      // ... 其他Bean保持不变
  }
  

• 修改AuditorAwareImpl的实现，直接返回用户邮箱，无需加载Member：

  public class AuditorAwareImpl implements AuditorAware<String>{
      private static Logger logger = LoggerFactory.getLogger(AuditorAwareImpl.class);
      
      @Override
      public String getCurrentAuditor() {
          Authentication authentication = SecurityContextHolder.getContext().getAuthentication();
          if(authentication == null){
              return null;
          }
          String userEmail = authentication.getPrincipal().toString();
          logger.info("JPA Audit username: [{}]", userEmail);
          return userEmail; // 直接返回邮箱，跳过Member查询
      }
  }
  

• 最后修改实体中的审计字段类型：

  @CreatedBy
  @LastModifiedBy
  private String createdBy; // 从Member改为String
  

方案2：优化实体关联加载，避免循环触发

如果必须存储Member实体作为审计字段，需要确保加载Member时不会触发关联的GalleryReply加载：

1. 确保双向关联使用懒加载：

   // GalleryReply中的关联
   @ManyToOne(fetch = FetchType.LAZY)
   @CreatedBy
   private Member createdBy;
   
   // Member中的关联
   @OneToMany(mappedBy = "createdBy", fetch = FetchType.LAZY)
   private List<GalleryReply> replies;
   

2. 修改memberService.findByEmail()，只查询Member的基本属性，不加载关联集合：
   用JPQL指定查询字段，避免JPA自动加载关联：

   public Member findByEmail(String email) {
       return entityManager.createQuery(
               "SELECT m FROM Member m WHERE m.email = :email", Member.class)
               .setParameter("email", email)
               .getSingleResult();
   }
   

   或者用Spring Data JPA的投影功能，只返回需要的字段（如果不需要完整的Member实体）：

   // 定义投影接口
   public interface MemberBasicInfo {
       Long getId();
       String getEmail();
       // 其他必要字段
   }
   
   // 在MemberRepository中添加方法
   MemberBasicInfo findByEmail(String email);
   

   注意：如果用投影，需要调整AuditorAware的泛型为投影类型，或者将投影转换为Member实体（如果业务需要）。

方案3：临时关闭更新时的审计（不推荐，除非业务允许）

如果你的业务不需要记录更新操作的修改人，可以在实体的@LastModifiedBy字段上添加条件，或者在@EntityListener中控制审计触发时机，但这会丢失更新审计信息，仅作为临时应急方案。

额外检查点 #

确认双向关联的mappedBy设置正确，避免JPA错误地创建额外的关联表或触发不必要的加载，这也是导致循环加载的常见诱因。

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